Your  Brain  on  Java — A Learner’s  Guide 


Learn  how  threads 
can  change  your  life 


2nd  Edition  - Covers  Java  5.0 


Head  First 


Avoid  embarassing 
00  mistakes 


Bend  your  mind 
around  42 
Java  puzzles 


_ hl'i 
4 j rcj-i/  Wt 


Make  Java  concepts 
stick  to  your  brain 


Fool  around  in 
the  Java  Library 


Make  attractive 
and  useful  GUIs 


O REILLY’ 


Kathy  Sierra  & Bert  Bates 


XXI 


Table  of  Contents  (summary) 

Intro 

1 Breaking  the  Surface:  a quick  dip  1 

2 A Trip  to  Objectville:  yes,  there  will  be  objects  27 

3 Know  Your  Variables:  primitives  and  references  49 

4 How  Objects  Behave:  object  state  effects  method  behavior  1 1 

5 Extra-Strength  Methods:  flow  control,  operations,  and  more  95 

6 Using  the  Java  Library:  so  you  don’t  have  to  write  it  all  yourself  125 

7 Better  Living  in  Objectville:  planning  for  the  future  165 

8 Serious  Polymorphism:  exploiting  abstract  classes  and  inte faces  197 

9 Life  and  Death  of  an  Object:  constructors  and  memory  management  235 

10  Numbers  Matter:  math,  formatting  wrappers,  and  statics  273 

1 1 Risky  Behavior:  exception  handling  315 

12  A Very  Graphic  Story:  intro  to  GUI,  event  handling  and  inner  classes  353 

13  Work  on  Your  Swing:  layout  managers  and  components  399 

14  Saving  Objects:  serialization  and  I/O  429 

15  Make  a Connection:  networking  sockets  and  multithreading  47 1 

16  Data  Structures:  collections  and  generics  529 

1 7 Release  Your  Code:  packaging  and  deployment  58 1 

18  Distributed  Computing:  RMIwith  a dash  of  servlets,  EJB,  andjini  607 

A Appendix  A:  Final  code  kitchen  649 

B Appendix  B:  Top  Ten  Things  that  didn’t  make  it  into  the  rest  of  the  book  659 

Index  677 


Table  of  Contents  (the  full  version) 

t Intro 

IYour  brain  on  Java.  Here  you  are  trying  to  learn  something,  while  here  your  brain 
is  doing  you  a favor  by  making  sure  the  learning  doesn't  stick.  Your  brain's  thinking, "Better 
leave  room  for  more  important  things,  like  which  wild  animals  to  avoid  and  whether  naked 
snowboarding  is  a bad  idea."  So  how  do  you  trick  your  brain  into  thinking  that  your  life 
depends  on  knowing  Java? 


Who  is  this  book  for?  xxii 

What  your  brain  is  thinking  xxiii 

Metacognition  xxv 

Bend  your  brain  into  submission  xxvii 

What  you  need  for  this  book  xxviii 

Technical  editors  xxx 

Acknowledgements  xxxi 


ix 


1 


Breaking  the  Surface 

Java  takes  you  to  new  places.  From  its  humble  release  to  the  public  as  the 
(wimpy)  version  1.02,  Java  seduced  programmers  with  its  friendly  syntax,  object-oriented 
features,  memory  management,  and  best  of  all — the  promise  of  portability.  We'll  take  a quick 
dip  and  write  some  code,  compile  it,  and  run  it.  We're  talking  syntax,  loops,  branching,  and  what 
makes  Java  so  cool.  Dive  in. 
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A Trip  to  Objectville 

I was  told  there  would  be  objects.  In  Chapter  1,  we  put  all  of  our  code 
in  the  main()  method.  That's  not  exactly  object-oriented.  So  now  we've  got  to  leave  that 
procedural  world  behind  and  start  making  some  objects  of  our  own.  We'll  look  at  what 
makes  object-oriented  (00)  development  in  Java  so  much  fun.  We'll  look  at  the  difference 
between  a class  and  an  object.  We'll  look  at  how  objects  can  improve  your  life. 


many  objects 


one  class 
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Chair  Wars  (Brad  the  OO  guy  vs.  Larry  the  procedural  guy) 
Inheritance  (an  introduction) 

Overriding  methods  (an  introduction) 

What’s  in  a class?  (methods,  instance  variables) 

Making  your  first  object 
Using  mainQ 
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Know  Your  Variables 

Variables  come  in  two  flavors:  primitive  and  reference. 

There's  gotta  be  more  to  life  than  integers.  Strings,  and  arrays.  What  if  you  have  a PetOwner 
object  with  a Dog  instance  variable?  Or  a Car  with  an  Engine?  In  this  chapter  we'll  unwrap 
the  mysteries  of  Java  types  and  look  at  what  you  can  declare  as  a variable,  what  you  can  put 
in  a variable,  and  what  you  can  do  with  a variable.  And  we'll  finally  see  what  life  is  truly  like 
on  the  garbage-collectible  heap. 


Dog  reference 


Declaring  a variable  (Java  cares  about  type) 

Primitive  types  (“IJd  like  a double  with  extra  foam,  please”) 
Java  keywords 

Reference  variables  (remote  control  to  an  object) 

Object  declaration  and  assignment 
Objects  on  the  garbage-collectible  heap 
Arrays  (a  first  look) 
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How  Objects  Behave 

State  affects  behavior,  behavior  affects  state.  We  know  that  objects 

have  state  and  behavior,  represented  by  instance  variables  and  methods.  Now  we'll  look 
at  how  state  and  behavior  are  related.  An  object's  behavior  uses  an  object's  unique  state. 

In  other  words,  methods  use  instance  variable  values.  Like, "if  dog  weight  is  less  than  14 
pounds,  make  yippy  sound,  else..."  Let's  go  change  some  state! 


pass-by-value  means 
pass-by-copy 


int  int 

foo.go(x);  void  go (int  z) { } 


Methods  use  object  state  (bark  different) 
Method  arguments  and  return  types 
Pass-by-value  (the  variable  is  always  copied) 
Getters  and  Setters 

Encapsulation  (do  it  or  risk  humiliation) 
Using  references  in  an  array 
Exercises  and  puzzles 
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Extra-Strength  Methods 

Let’s  put  some  muscle  in  our  methods.  You  dabbled  with  variables, 

played  with  a few  objects,  and  wrote  a little  code.  But  you  need  more  tools.  Like 
operators.  And  loops.  Might  be  useful  to  generate  random  numbers.  And  turn 
a String  into  an  int,  yeah,  that  would  be  cool.  And  why  don't  we  learn  it  all  by  building 
something  real,  to  see  what  it's  like  to  write  (and  test)  a program  from  scratch.  Maybe  a 
game,  like  Sink  a Dot  Com  (similar  to  Battleship). 


Building  the  Sink  a Dot  Com  game  96 

Starting  with  the  Simple  Dot  Com  game  (a  simpler  version)  98 

Writing  prepcode  (pseudocode  for  the  game)  1 00 

Test  code  for  Simple  Dot  Com  102 

Coding  the  Simple  Dot  Com  game  103 

Final  code  for  Simple  Dot  Com  106 

Generating  random  numbers  with  Math.randomQ  1 1 1 

Ready-bake  code  for  getting  user  input  from  the  command-line  112 

Looping  with  for  loops  1 1 4 

Casting  primitives  from  a large  size  to  a smaller  size  117 

Converting  a String  to  an  int  with  Integer.parselnt()  1 1 7 

Exercises  and  puzzles  1 18 


Using  the  Java  Library 

Java  ships  with  hundreds  of  pre-built  classes.  You  don't  have  to 

reinvent  the  wheel  if  you  know  how  to  find  what  you  need  from  the  Java  library,  commonly 
known  as  the  Java  API.  You've  got  better  things  to  do.  If  you're  going  to  write  code,  you 
might  as  well  write  only  the  parts  that  are  custom  for  your  application. The  core  Java  library 
is  a giant  pile  of  classes  just  waiting  for  you  to  use  like  building  blocks. 


“ Good  to  know  there’s  an  Array  List  in 
the  java,  util  package.  But  by  myself,  how 
would  I have  figured  that  out?” 


Analying  the  bug  in  the  Simple  Dot  Com  Game 
Array  List  (taking  advantage  of  the  Java  API) 

Fixing  the  DotCom  class  code 
Building  the  real  game  (Sink  a Dot  Com) 

Prepcode  for  the  real  game 
Code  for  the  real  game 
boolean  expressions 
Using  the  library  Java  API) 
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Using  the  HTML  API  docs  and  reference  books 
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126 

132 

138 

140 

144 

146 

151 

154 

155 
158 
161 


xii 


7 


Better  Living  in  Objectville 

Plan  your  programs  with  the  future  in  mind.  What  if  you  could  write 

code  that  someone  else  could  extend,  easily?  What  if  you  could  write  code  that  was  flexible, 
for  those  pesky  last-minute  spec  changes?  When  you  get  on  the  Polymorphism  Plan,  you'll 
learn  the  5 steps  to  better  class  design,  the  3 tricks  to  polymorphism,  the  8 ways  to  make 


flexible  code,  and  if  you  act  now — a bonus  lesson  on  the  4 tips  for  exploiting  inheritance. 
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Understanding  inheritance  (superclass  and  subclass  relationships)  168 

Designing  an  inheritance  tree  (the  Animal  simulation)  170 

Avoiding  duplicate  code  (using  inheritance)  171 

Overriding  methods  1 7 2 

IS-A  and  HAS-A  (bathtub  girl)  177 

What  do  you  inherit  from  your  superclass?  180 

What  does  inheritance  really  buy  you?  182 

Polymorphism  (using  a supertype  reference  to  a subclass  object)  183 

Rules  for  overriding  (don’t  touch  those  arguments  and  return  types!)  190 
Method  overloading  (nothing  more  than  method  name  re-use)  191 

Exercises  and  puzzles  192 


Serious  Polymorphism 

Inheritance  is  just  the  beginning.  To  exploit  polymorphism,  we  need 
interfaces.  We  need  to  go  beyond  simple  inheritance  to  flexibility  you  can  get  only  by 
designing  and  coding  to  interfaces.  What's  an  interface?  A 100%  abstract  class.  What's  an 
abstract  class?  A class  that  can't  be  instantiated.  What's  that  good  for?  Read  the  chapter... 


Object  o = al.get(id); 
Dog  d = (Dog)  o; 

d . bark ( ) ; 


Some  classes  just  should  not  be  instantiated 
Abstract  classes  ( can’t  be  instantiated) 

Abstract  methods  (must  be  implemented) 

Polymorphism  in  action 

Class  Object  (the  ultimate  superclass  of  everything ) 

Taking  objects  out  of  an  Array  List  (they  come  out  as  type  Object) 
Compiler  checks  the  reference  type  (before  letting  you  call  a method) 
Get  in  touch  with  your  inner  object 
Polymorphic  references 

Casting  an  object  reference  (moving  lower  on  the  inheritance  tree) 
Deadly  Diamond  of  Death  (multiple  inheritance  problem) 

Using  interfaces  (the  best  solution!) 

Exercises  and  puzzles 
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Life  and  Death  of  an  Object 

Objects  are  born  and  objects  die.  You're  in  charge.  You  decide  when  and 
how  to  construct  them.  You  decide  when  to  abandon  them.  The  Garbage  Collector  (gc) 
reclaims  the  memory.  We'll  look  at  how  objects  are  created,  where  they  live,  and  how  to 
keep  or  abandon  them  efficiently.That  means  we'll  talk  about  the  heap,  the  stack,  scope, 
constructors,  super  constructors,  null  references,  and  gc  eligibility. 


The  stack  and  the  heap,  where  objects  and  variables  live 

Methods  on  the  stack 

Where  local  variables  live 

Where  instance  variables  live 

The  miracle  of  object  creation 

Constructors  (the  code  that  runs  when  you  say  new) 

Initializing  the  state  of  a new  Duck 

Overloaded  constructors 

Superclass  constructors  (constructor  chaining) 
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Life  of  an  object 

Garbage  Collection  (and  making  objects  eligible) 
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Static  variables 
are  shared  by 
all  instances  of 
a class. 


Numbers  Matter 

Do  the  Math  . The  Java  API  has  methods  for  absolute  value,  rounding,  min/max,  etc. 
But  what  about  formatting?  You  might  want  numbers  to  print  exactly  two  decimal  points, 
or  with  commas  in  all  the  right  places.  And  you  might  want  to  print  and  manipulate  dates, 
too.  And  what  about  parsing  a String  into  a number?  Or  turning  a number  into  a String? 
We'll  start  by  learning  what  it  means  for  a variable  or  method  to  be  static. 


s-tatid  variable: 
ideCrear* 


instande  variables: 
one  per  insjande 


s-ta-fcid  variables: 
one  per  dlass 
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Math  class  (do  you  really  need  an  instance  of  it?)  274 

static  methods  275 

static  variables  277 

Constants  (static  final  variables)  282 

Math  methods  (randomQ,  roundQ,  abs(),  etc.)  286 

Wrapper  classes  (Integer,  Boolean,  Character,  etc.)  287 

Autoboxing  289 

Number  formatting  294 

Date  formatting  and  manipulation  30 1 

Static  imports  307 

Exercises  and  puzzles  310 
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Risky  Behavior 

Stuff  happens.  The  file  isn't  there.The  server  is  down.  No  matter  how  good  a 
programmer  you  are,  you  can't  control  everything.  When  you  write  a risky  method,  you  need 
code  to  handle  the  bad  things  that  might  happen.  But  how  do  you  know  when  a method  is 
risky?  Where  do  you  put  the  code  to  handle  the  exceptional  situation?  In  this  chapter,  we're 
going  to  build  a MIDI  Music  Player,  that  uses  the  risky  JavaSound  API,  so  we  better  find  out. 


risky  method 


Making  a music  machine  (the  BeatBox) 

What  if  you  need  to  call  risky  code? 

Exceptions  say  “something  bad  may  have  happened...” 

The  compiler  guarantees  (it  checks)  that  you’re  aware  of  the  risks 
Catching  exceptions  using  a try /catch  (skateboarder) 

Flow  control  in  try /catch  blocks 

The  finally  block  (no  matter  what  happens,  turn  off  the  oven!) 
Catching  multiple  exceptions  (the  order  matters) 

Declaring  an  exception  (just  duck  it) 

Handle  or  declare  law 
Code  Kitchen  (making  sounds) 

Exercises  and  puzzles 
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A Very  Graphic  Story 

Face  it,  you  need  to  make  GUIs.  Even  if  you  believe  that  for  the  rest  of  your 
life  you'll  write  only  server-side  code,  sooner  or  later  you'll  need  to  write  tools,  and  you'll 
want  a graphical  interface.  We'll  spend  two  chapters  on  GUIs,  and  learn  more  language 
features  including  Event  Handling  and  Inner  Classes.  We'll  put  a button  on  the  screen, 


Exercises  and  puzzles 


394 
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Work  on  your  Swing 

Swing  is  easy.  Unless  you  actually  care  where  everything  goes.  Swing  code  looks 
easy,  but  then  compile  it,  run  it,  look  at  it  and  think, "hey,  that's  not  supposed  to  go  there." 
The  thing  that  makes  it  easy  to  code  is  the  thing  that  makes  it  hard  to  control — the  Layout 
Manager.  But  with  a little  work,  you  can  get  layout  managers  to  submit  to  your  will.  In 
this  chapter,  we'll  work  on  our  Swing  and  learn  more  about  widgets. 
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Swing  Components 

Layout  Managers  (they  control  size  and  placement) 

Three  Layout  Managers  (border,  flow,  box) 

BorderLayout  (cares  about  five  regions) 

FlowLayout  (cares  about  the  order  and  preferred  size) 
BoxLayout  (like  flow,  but  can  stack  components  vertically) 
JTextField  (for  single-line  user  input) 

JTextArea  (for  multi-line,  scrolling  text) 

JCheckBox  (is  it  selected?) 

JList  (a  scrollable,  selectable  list) 

Code  Kitchen  (The  Big  One  - building  the  BeatBox  chat  client) 
Exercises  and  puzzles 
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Saving  Objects 

Objects  can  be  flattened  and  inflated.  Objects  have  state  and  behavior. 
Behavior  lives  in  the  class,  but  state  lives  within  each  individual  object.  If  your  program 
needs  to  save  state, you  can  do  it  the  hard  way,  interrogating  each  object,  painstakingly 
writing  the  value  of  each  instance  variable.  Or,  you  can  do  it  the  easy  OO  way — you  simply 
freeze-dry  the  object  (serialize  it)  and  reconstitute  (deserialize)  it  to  get  it  back. 


Saving  object  state  43 1 

Writing  a serialized  object  to  a file  432 

Java  input  and  output  streams  (connections  and  chains)  433 

Object  serialization  434 

Implementing  the  Serializable  interface  437 

Using  transient  variables  439 

Deserializing  an  object  441 

Writing  to  a text  file  447 

java.io.File  452 

Reading  from  a text  file  454 

Splitting  a String  into  tokens  with  split()  458 

CodeKitchen  462 

Exercises  and  puzzles  466 
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Make  a Connection 

Connect  with  the  outside  world,  it  s easy.  All  the  low-level  networking 
details  are  taken  care  of  by  classes  in  the  java.net  library.  One  of  Java's  best  features  is 
that  sending  and  receiving  data  over  a network  is  really  just  I/O  with  a slightly  different 
connection  stream  at  the  end  of  the  chain.  In  this  chapter  we'll  make  client  sockets.  We'll 
make  server  sockets.  We'll  make  clients  and  servers.  Before  the  chapter's  done, you'll  have  a 
fully-functional,  multithreaded  chat  client.  Did  we  just  say  multithreaded ? 


Ghat  program  overview  473 
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Network  sockets  475 
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Reading  data  from  a socket  (using  BufferedReader)  478 
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Launching  a new  thread  (make  it,  start  it)  492 

The  Runnable  interface  (the  thread’s  job)  494 

Three  states  of  a new  Thread  object  (new,  runnable,  running)  495 

The  runnable-running  loop  496 

Thread  scheduler  (it’s  his  decision,  not  yours)  497 

Putting  a thread  to  sleep  501 

Making  and  starting  two  threads  503 

Concurrency  issues:  can  this  couple  be  saved?  505 

The  Ryan  and  Monica  concurrency  problem,  in  code  506 

Locking  to  make  things  atomic  510 

Every  object  has  a lock  5 1 1 

The  dreaded  “Lost  Update”  problem  5 1 2 

Synchronized  methods  (using  a lock)  514 

Deadlock!  5 1 6 

Multithreaded  ChatClient  code  518 

Ready-bake  SimpleChatServer  520 

Exercises  and  puzzles  524 
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Data  Structures 

Sorting  is  a snap  in  Java.  You  have  all  the  tools  for  collecting  and  manipulating 
your  data  without  having  to  write  your  own  sort  algorithms  The  Java  Collections 
Framework  has  a data  structure  that  should  work  for  virtually  anything  you'll  ever  need 
to  do.  Want  to  keep  a list  that  you  can  easily  keep  adding  to?  Want  to  find  something  by 
name?  Want  to  create  a list  that  automatically  takes  out  all  the  duplicates?  Sort  your  co- 
workers by  the  number  of  times  they've  stabbed  you  in  the  back? 


List 


Set 


Map 


Collections 

Sorting  an  ArrayList  with  Collections. sortO 
Generics  and  type-safety 

Sorting  things  that  implement  the  Comparable  interface 

Sorting  things  with  a custom  Comparator 

The  collection  API — lists,  sets,  and  maps 

Avoiding  duplicates  with  HashSet 

Overriding  hashCodeO  and  equals0 

HashMap 

Using  wildcards  for  polymorphism 
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Release  Your  Code 

It’s  time  to  let  go.  You  wrote  your  code.  You  tested  your  code.  You  refined  your  code. 
You  told  everyone  you  know  that  if  you  never  saw  a line  of  code  again,  that'd  be  fine.  But  in 
the  end,  you've  created  a work  of  art.  The  thing  actually  runs!  But  now  what?  In  these  final 
two  chapters,  we'll  explore  how  to  organize,  package,  and  deploy  your  Java  code.  We'll  look 
at  local,  semi-local,  and  remote  deployment  options  including  executable  jars,  Java  Web 
Start,  RMI,  and  Servlets.  Relax.  Some  of  the  coolest  things  in  Java  are  easier  than  you  think. 


Deployment  options  582 

Keep  your  source  code  and  class  files  separate  584 

Making  an  executable  JAR  Java  ARchives)  585 

Running  an  executable  JAR  586 

Put  your  classes  in  a package!  587 

Packages  must  have  a matching  directory  structure  589 

Compiling  and  running  with  packages  590 

Compiling  with  -d  591 

Making  an  executable  JAR  (with  packages)  592 

Java  Web  Start  JWS)  for  deployment  from  the  web  597 

How  to  make  and  deploy  a JWS  application  600 

Exercises  and  puzzles  60 1 
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Distributed  Computing 

Being  remote  doesn’t  have  to  be  a bad  thing.  Sure,  things  ore  easier 

when  all  the  parts  of  your  application  are  in  one  place,  in  one  heap,  with  one  JVM  to  rule 
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The  Top  Ten  Things  that  didn’t  make  it  into  the  book.  We  can't  send 

you  out  into  the  world  just  yet.  We  have  a few  more  things  for  you,  but  this  is  the  end  of  the 
book.  And  this  time  we  really  mean  it. 
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how  to  use  this  book 


Who  is  this  book  for? 

If  you  can  answer  "yes”  to  al l of  these; 

0’  Have  you  done  some  programming? 

(2)  Do  you  want  to  learn  Java? 

0 Do  you  prefer  stimulating  dinner  party 
conversation  to  dry,  dull,  technical 
lectures? 

this  book  is  for  you. 


This  is  NOT  a reference 
book.  Head  First  Java  is  a 
book  designed  for  learning, 
not  an  encyclopedia  of 
Java  facts. 


Who  should  probably  back  away  from  this  book? 

If  you  can  answer  'yes”  to  any  one  of  these: 

0 Ib  your  programming  background  limited 
to  HTML  only,  with  no  acrlptlng  language 
experience? 

(If  you’ve  done  anything  with  looping;  or  if/ then 
logic*  you’11  do  fine  with  this  book,  but  HTML 
tagging  alone  might  not  be  enough.) 

(2)  Are  you  a kick-butt  C++  programmer 
looking  for  a reference  book? 


0 Are  you  afraid  to  try  something  different? 
Would  you  rather  have  a root  canal  than 
mix  stripes  with  plaid?  Do  you  believe 
than  a technical  book  can’t  be  serious  If 
there’s  a picture  of  a duck  in  the  memory 
management  section? 

this  book  is  not  for  you. 
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We  know  what  you're  thinking. 

uHow  can  this  be  a serious  Java  programming  book?” 
“What's  with  all  the  graphics?” 

"Can  I actually  team  it  this  way?” 

"Do  I smell  pfrza?” 


And  we  know  what  your  brain  is  thinking. 

Your  brain  craves  novelty.  It’s  always  searching,  scanning,  waiting  for 
something  unusual.  It  was  built  that  way,  and  it  helps  you  stay  alive. 

Today,  you're  less  likely  to  be  a tiger  snacL  But  your  brain's  still 
looking.  You  just  never  know. 

So  what  does  your  brain  do  with  all  the  routine,  ordinary,  normal  . 
things  you  encounter?  Everything  it  canto  stop  them  from  I 

interfering  with  the  brain 's  realjob — recording  things  that  matter . It 
doesn't  bother  saving  the  boring  things;  they  never  make  it  past  the 
"this  is  obviously  not  important”  filter 

How  does  your  brain  know  what's  important?  Suppose  you're  out  for 
a day  hike  and  a tiger  jumps  in  front  of  you,  what  happens  inside  your 
head? 

Neurons  fire.  Emotions  crank  up.  Chemicals  surge 
And  that’s  how  your  brain  knows... 

This  must  be  Important!  Don't  forget  Itl 

But  imagine  you're  at  home,  or  in  a library.  It’s  a safe,  warm,  tiger-free 
zone.  You're  studying.  Getting  ready  for  an  exam.  Or  trying  to  learn 
some  cough  technical  topic  your  boss  thinks  will  take  a week,  ten  days 
at  the  most 

Just  one  problem.  Your  brain's  trying  to  do  you  a big  favor.  It’s 
trying  to  make  sure  that  this  obviously  non-important  content 
doesn't  clutter  up  scarce  resources.  Resources  that  are  better  \mmm 
spent  storing  the  really  toothings.  Like  tigers.  Like  the  danger  of 
fire.  Like  how  you  should  never  again  snowboard  in  short s.  gw 

And  there’s  no  simple  way  to  tell  your  brain,  “Hey  brain,  thank  wA 
you  very  much,  btit  no  matter  how  dull  this  book  is,  and  how  t 
little  I’m  registering  on  the  emotional  richter  scale  right  now,  I m 
really  do  want  you  to  keep  this  stuff  around.”  m 
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Great.  Only 
637  more  dull,  dry, 
boring  pages. 
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We  fexk  of  a “Head  First  Java”  reader  as  a learner. 

So  what  does  It  take  to  /earn  something?  First,  you  have  to  get  It,  then  make  sure 
you  don’t  forget  it  It’s  not  about  pushing  facts  Into  your  head.  Based  on  the 
latest  research  In  cognitive  science,  neurobiology,  and  educational  psychology, 
learning  takes  a lot  more  than  text  on  a page.  We  know  what  turns  your  brain  on. 
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Get — and  keep — the  reader's  attention-  WeVe  all 
had  the  "I  really  want  to  learn  this  but  l can't  stay  awake  past 
page  one'  experience.  Your  brain  pays  attention  to  things  that  are  out 
of  the  ordinary,  interesting,  strange,  eye-catching,  unexpected.  Learning  a new, 
tough,  technical  topic  doesn't  have  to  be  boring.  Your  brain  will  learn  much  more  quickly  if  it's  not. 


Some  of  the  Head  First  learning  principles: 

Make  It  visual.  Images  are  far  more  memorable  than  words 
alone,  and  make  learning  much  more  effective  (Up  to  89% 

Improvement  in  recall  and  transfer  studies).  It  also  makes 
things  more  understandable.  Put  the  words  within 
or  near  the  graphics  they  relate  to,  rather  than  on  the 
bottom  or  on  another  page,  and  learners  will  be  up  to  twice 
as  likely  to  solve  problems  related  to  the  content. 

Use  a conversational  and  personalized  style.  In  recent  studies, 

students  performed  up  to  40%  better  on  post-learning  tests  if  the  content  spoke 
directly  to  the  reader,  using  a first-person,  conversational  style  rather  than 
taking  a formal  tone. Tell  stories  instead  of  lecturing.  Use  casual  language.  Don't 
take  yourself  too  seriously.  Which  would  you  pay  more  attention  to:  a stimulating 
dinner  party  companion,  or  a lecture? 


Get  the  learner  to  think  more  deeply.  In  other  words,  unless 
you  actively  flex  your  neurons,  nothing  much  happens  in  your  head. 

A reader  has  to  be  motivated,  engaged,  curious,  and  inspired  to 
solve  problems,  draw  conclusions,  and  generate  new  knowledge. 

And  for  that,  you  need  challenges,  exercises,  and  thought- 
roam  ( ) ; provoking  questions,  and  activities  that  involve  both  sides 
^ of  the  brain,  and  multiple  senses. 
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Touch  their  emotions.  We  now  know  that  your  ability  to  remember  something  Is  largely 
dependent  on  Its  emotional  content  You  remember  what  you  care  about  You  remember  when 
you  feel  something.  No  we're  not  talking  heart -wrenching  stories  about  a boy  and  his  dog. 

We're  talking  emotions  like  surprise,  curiosity, fun/what  the...?', and  the  feeling  of  "I  Rule!' 
that  comes  when  you  solve  a puzzle,  learn  something  everybody  else  thinks  Is  hard,  or  realize 
you  know  something  that 'I'm  more  technical  than  thou' Bob  from  engineering  doesn't. 
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Metacognitiow:  thinking  about  thinking. 

If  you  really  want  to  learn,  and  you  want  to  learn  more  qtiickly  and  more  deeply, 
pay  attention  to  how  you  pay  attention.  Think  about  how  you  think.  Learn  how 
you  learn. 

Most  of  us  did  not  take  courses  on  metacognition  or  learning  theory  when  we  were 
growing  up.  We  were  expected  to  learn,  but  rarely  taught  to  learn. 

But  we  assume  that  if  you're  holding  this  book,  you  want  to  learn  Java.  And  you 
probably  don't  want  to  spend  a lot  of  time. 

To  get  the  most  from  this  book,  or  any  book  or  learning  experience,  take 
responsibility  for  your  brain.  Your  brain  on  that  content. 

The  trick  is  to  get  your  brain  to  see  the  new  material  you’re  learning 
as  Really  Important.  Crucial  to  your  well-being.  As  important  as 
a tiger.  Otherwise,  you’re  in  for  a constant  battle,  with  your  brain 
doing  its  best  to  keep  the  new  content  from  sticking. 


So  Just  how  DO  you  got  your  brain  to  treat  Java  like  It 
was  a hungry  tiger? 

There’s  the  slow,  tedious  way,  or  die  faster,  more  effective  way.  The 
slow  way  is  about  sheer  repetition.  You  obviously  know  that  you  are 
able  to  learn  and  remember  even  the  dullest  of  topics,  if  you  keep  pounding 
on  the  same  thing.  With  enough  repetition,  your  brain  says,  ‘This  doesn't  feel 
important  to  him,  but  he  keeps  looking  at  the  same  thing  over  and  m/erand  over,  so 
I suppose  it  must  be." 


The  faster  way  is  to  do  anything  that  increases  brain  activity,  especially  different  types 
of  brain  activity.  The  things  on  the  previous  page  are  a big  part  of  the  solution, 
and  they're  all  things  that  have  been  proven  to  help  your  brain  work  in  your  favor. 
For  example,  studies  show  that  putting  words  within  the  pictures  they  describe  (as 
opposed  to  somewhere  else  in  the  page,  like  a caption  or  in  the  body  text)  causes 
vour  brain  to  try  to  makes  sense  of  how  the  words  and  picture  relate,  and  this 
causes  more  neurons  to  fire.  More  neurons  firing  = more  chances  for  your  brain 
to  get  that  this  is  something  worth  paying  attention  to,  and  possibly  recording. 

A conversational  style  helps  because  people  tend  to  pay  more  attention  when  they 
perceive  that  they’re  jn  a conversation,  since  they’re  expected  to  follow  along  and 
hold  up  their  end.  The  amazing  thing  is,  your  brain  doesn’t  necessarily  care  that 
the  * conversation"  is  between  you  and  a book!  On  the  other  hand,  if  the  writing 
style  is  formal  and  dry,  your  brain  perceives  it  the  same  way  you  experience  being 
lectured  to  while  sitting  in  a roomful  of  passive  attendees.  No  need  to  stay  awake. 

But  pictures  and  conversational  style  are  just  the  beginning. 
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Here's  what  WE  did: 

We  used  pictures , because  your  brain  is  tuned  for  visuals,  not  text  As  far  as  your 
brain's  concerned,  a picture  really  is  worth  1024  words.  And  when  text  and  pictures 
work  together,  we  embedded  the  text  in  the  pictures  because  your  brain  works 
more  effectively  when  the  text  is  within  the  thing  the  text  refers  to,  as  opposed  to  in 
a caption  or  buried  in  the  text  somewhere. 

We  used  repetition,  saying  the  same  thing  in  different  ways  and  with  different  media 
types,  and  multiple  senses , to  increase  the  chance  that  the  content  gets  coded  coded 
into  more  than  one  area  of  your  brain. 

We  used  concepts  and  pictures  in  unexpected  ways  because  your  brain  is  tuned  for 
novelty,  and  we  used  pictures  and  ideas  with  at  least  some  emotional  content  because 
your  brain  is  tuned  to  pay  attention  to  the  biochemistry  of  emotions.  That  which 
causes  you  to  /^/something  is  more  likely  to  be  remembered,  even  if  that  feeling  is 
nothing  more  than  a little  humor ; surprise , or  interest 

We  used  a personalized,  conversational  style,  because  your  brain  is  tuned  to  pay  more 
attention  when  it  believes  you're  in  a conversation  than  if  it  thinks  you're  passively 
listening  to  a presentation.  Your  brain  does  this  even  when  you're  reading. 

We  included  more  than  50  exercises , because  your  brain  is  tuned  to  learn  and 
remember  more  when  you  do  things  than  when  you  read  about  things.  And  we 
made  the  exercises  challenging-yet-do-able,  because  that's  what  most  people  prefer. 

We  used  multiple  learning  styles , because  you  might  prefer  step-by-step  procedures, 
while  someone  else  wants  to  understand  the  big  picture  first,  while  someone  else 
just  wants  to  see  a code  example.  But  regardless  of  your  own  learning  preference, 
everyone  benefits  from  seeing  the  same  content  represented  in  multiple  ways. 

We  include  content  for  both  sides  of  your  brain,  because  the  more  of  your  brain  you 
engage,  the  more  likely  you  are  to  learn  and  remember,  and  the  longer  you  can 
stay  focused.  Since  working  one  side  of  the  brain  often  means  giving  the  other  side 
a chance  to  rest,  you  can  be  more  productive  at  learning  for  a longer  period  of 
time. 

And  we  included  stories  and  exercises  that  present  more  than  one  point  of  view, 
because  your  brain  is  tuned  to  learn  more  deeply  when  it's  forced  to  make 
evaluations  and  judgements. 

We  included  chaBenges , with  exercises,  and  by  asking  questions  that  don't  always  have 
a straight  answer,  because  your  brain  is  tuned  to  learn  and  remember  when  it  has 
to  work  at  something  (just  as  you  can't  get  your  body  in  shape  by  watching  people 
at  the  gym).  But  we  did  our  best  to  make  sure  that  when  you're  working  hard,  it's 
on  the  right  things.  Thai  you’re  not  spending  one  extra  dendrite  processing  a hard- to- 
understand  example,  or  parsing  difficult,  jargon-laden,  or  extremely  terse  text. 

We  used  an  80/20  approach.  We  assume  that  if  you're  going  for  a PhD  in  Java, 
this  won’t  be  your  only  book.  So  we  don't  talk  about  everything.  Just  the  stuff  you’ll 
actually  use 
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Here's  what  YOU  can  do  to  bend  your 
brain  into  submission. 


So,  we  did  our  part  The  rest  is  up  to  you.  These  tips  are  a 
starting  point;  Listen  to  your  brain  and  figure  out  what  works 
for  you  and  what  doesn't  Try  new  things. 
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0 Slow  down.  Tho  more  you  understand, 
the  less  you  have  to  memorize. 

Don’tjust  read.  Stop  and  think.  When  the 
book  asks  you  a question,  don't  just  skip  to 
the  answer.  Imagine  that  someone  really  is 
asking  the  question.  The  more  deeply  you 
force  your  brain  to  think,  the  better  chance 
you  have  of  learning  and  remembering. 

0 Do  the  exercises.  Write  your  own  notes. 

We  put  them  in,  but  if  we  did  them  for  you, 
that  would  be  like  having  someone  else 
do  your  workouts  for  you.  And  don't  just 
look  at  the  exercises.  Use  a pencil*  There’s 
plenty  of  evidence  that  physical  activity 
while  learning  can  increase  the  learning. 

0 Read  the  ‘'There  are  No  Dumb  Questions” 

That  means  all  of  them.  They’re  not 
optional  side-bars — diey're  part  of  the  core 
content!  Sometimes  die  questions  are  more 
useful  than  the  answers. 


^ Drink  water.  Lots  of  it. 

Your  brain  works  best  in  a nice  bath  of  fluid* 
Dehydration  (which  can  happen  before  you 
ever  feel  thirsty)  decreases  cognitive  function. 

||  Talk  about  it.  Out  loud. 

Speaking  activates  a different  part  of 
the  brain.  If  you’re  trying  to  understand 
something,  or  increase  your  chance  of 
remembering  it  later,  say  it  out  loud.  Better 
still,  try  to  explain  it  out  loud  to  someone 
else.  You’ll  learn  more  quickly,  and  you  might 
uncover  ideas  you  hadn’t  known  were  there 
when  you  were  reading  about  it. 

^ Listen  to  your  brain. 

Pay  attention  to  whether  your  brain  is  getting 
overloaded.  If  you  find  yourself  starting  to  skim 
die  surface  or  forget  what  you  just  read,  it’s 
time  for  a break.  Once  you  go  past  a certain 
point,  you  won't  learn  faster  by  trying  to  shove 
more  in,  and  you  might  even  hurt  die  process. 


^ Don’t  do  all  your  reading  in  one  place. 

Stand-up,  stretch,  move  around,  change 
chairs,  change  rooms.  It’ll  help  your  brain 
/^/something,  and  keeps  your  learning  from 
being  too  connected  to  a particular  place. 


^ Feel  something! 

Your  brain  needs  to  know  that  this  matters * Get 
involved  with  the  stories.  Make  up  your  own 
captions  for  the  photos.  Groaning  over  a bad 
joke  is  still  better  than  feeling  nothing  at  all* 


@ Make  this  the  last  thing  you  read  before 
bed.  Or  at  least  the  last  challenging  thing. 

Part  of  the  learning  (especially  the  transfer 
to  long-term  memory)  happens  after  you  put 
the  book  down.  Your  brain  needs  time  on 
its  own,  to  do  more  processing.  If  you  put  in 
something  new  during  that  processing-time, 
some  of  what  you  just  learned  will  be  lost. 


^ Type  and  run  the  code. 

Type  and  run  the  code  examples.  Then  you 
can  experiment  with  changing  and  improving 
the  code  (or  breaking  it,  which  is  sometimes 
the  best  way  to  figure  out  what's  really 
happening).  For  long  examples  or  Ready-bake 
code,  you  can  download  die  source  files  from 
headfirstjava.com 
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What  you  need  for  this  book: 

You  do  not  need  any  other  development  tool,  such  as  an  Integrated 
Development  Environment  (IDE).  We  strongly  recommend  that  you  not 
use  anything  but  a basic  text  editor  until  you  complete  this  book  (and 
especially  not  until  after  chapter  16) . An  IDE  can  protect  you  from  some  of 
the  details  that  really  matter,  so  you're  much  better  off  learning  from  the 
command-line  and  then,  once  you  really  understand  what's  happening, 
move  to  a tool  that  automates  some  of  the  process. 

I SETTING  UP  JAVA 

■ If  you  don't  already  have  a 1 .5  or  greater  Java  2 Standard  Edition  SDK  (Software 
Development  Kit),  you  need  if.  If  you’re  on  Linux,  Windows,  or  Solaris,  you  can  gel  it  for  free 
from  java.sun.com  (Sun's  website  for  Java  developers).  It  usually  takes  no  more  than  two  clicks 
from  the  main  page  to  get  to  the  J2SE  downloads  page.  Get  the  latest  non-beta  version  posted. 
Die  SDK  includes  everything  you  need  to  compile  and  run  Java. 

If  you're  running  Mac  OS  X 10.4,  the  Java  SDK  is  already  installed.  It's  part  of  OS  X,  and  you 
don’t  have  to  do  anything  else.  If  you're  on  an  earlier  version  of  OS  X,  you  have  an  earlier 
version  of  Java  that  will  work  for  95%  of  the  code  in  this  book. 

Note:  This  book  is  based  on  Java  1 .5,  but  for  stunningly  unclear  marketing  reasons,  shortly 
before  release,  Sun  renamed  It  Java  5,  while  still  keeping  "1.5"  as  the  version  number  for  the 
developer's  kit  So,  if  you  see  Java  1.5  or  Java  5 or  Java  5.0,  or  'Tiger'  (version  5’s  original 
code-name),  they  all  mean  the  same  thing.  There  was  never  a Java  3.0  or  4.0— it  jumped  from 
version  1 .4  to  5.0,  but  you  will  still  find  places  where  it’s  called  1 .5  instead  of  5.  Don't  ask. 

(Oh,  and  just  to  make  it  more  entertaining,  Java  5 and  the  Mac  OS  X 10.4  were  both  given  the 
same  code-name  of  'Tiger’,  and  since  OS  X 10.4  is  the  version  of  the  Mac  OS  you  need  to  run 
Java  5,  you'll  hear  people  talk  about  “Tiger  on  Tiger’.  It  just  means  Java  5 on  OS  X 10,4). 

B The  SDK  does  not  include  the  API  documentation,  and  you  need  that!  Go  back  to  java.sun . 
com  and  get  the  J2SE  API  documentation.  You  can  also  access  the  API  docs  online,  without 
downloading  them,  but  that's  a pain.  Trust  us,  ifs  worth  the  download. 

■ You  need  a text  editor.  Virtually  any  text  editor  will  do  (vi,  emacs,  pico),  including  the  GUI  ones 
that  come  with  most  operating  systems.  Notepad,  Wordpad,  TextEdit,  etc.  all  work,  as  long  as 
you  make  sure  they  don’t  append  a “.bd”  on  to  the  end  of  your  source  code. 

■ Once  you've  downloaded  and  unpacked/zipped/whatever  (depends  on  which  version  and  for 
which  OS),  you  need  to  add  an  entry  to  your  PATH  environment  variable  that  points  to  the  /bin 
directory  inside  the  main  Java  directory.  For  example,  if  the  J2SDK  puts  a directory  on  your 
drive  called  ‘j2sdk1.5.0’,  look  inside  that  directory  and  you'll  find  the  "bin"  directory  where  the 
Java  binaries  (the  tools)  live.  Tha  bin  directory  is  the  one  you  need  a PATH  to,  so  that  when  you 
type: 

% javac 

at  the  command-line,  your  terminal  will  know  how  to  find  the  javac  compiler, 

Note:  if  you  have  trouble  with  you  installation,  we  recommend  you  go  to  javaranch.com,  and  join 
the  Java-Beginning  forum!  Actually,  you  should  do  that  whether  you  have  trouble  or  not. 

Note:  much  of  the  code  from  this  book  Is  available  at  wlckedlysmart.com 
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last-minute  things  you  need  to  know: 

This  is  a learning  experience,  not  a reference  book.  We  deliberately 
stripped  out  everything  that  might  get  in  the  way  of  learning  whatever  it 
is  we’re  working  on  at  that  point  in  the  book.  And  the  first  time  through, 
you  need  to  begin  at  the  beginning,  because  the  book  makes  assumptions 
about  what  you’ve  already  seen  and  learned. 

We  use  simple  UML-fffre  diagrams. 

If  we’d  used  pure\JML>  you’d  be  seeing  something  that  looks  like  Java,  but 
with  syntax  that’s  just  plain  wrong.  So  we  use  a simplified  version  of  UML 
that  doesn’t  conflict  with  Java  syntax.  If  you  don’t  already  know  UML,  you 
won't  have  to  worry  about  leamingjava  and  UML  at  the  same  dme. 

We  don't  worry  about  organizing  and  packaging  your  own 
code  until  the  end  of  the  book. 

In  this  book,  you  can  get  on  with  the  business  of  leamingjava,  without 
stressing  over  some  of  the  organizational  or  administrative  details  of 
developingjava  programs.  You  willy  in  the  real  world,  need  to  know — and 
use — these  details,  so  we  cover  them  in  depth.  But  we  save  them  for  the  end 
of  the  book  {chapter  17).  Relax  while  you  ease  into  Java,  gently 

The  end-of-chapter  exercises  are  mandatory;  puzzles  are 
optional.  Answers  for  both  are  at  the  end  of  each  chapter. 

One  thing  you  need  to  know  about  the  puzzles — they  're  puzzles . As  in  logic 
puzzles,  brain  teasers,  crossword  puzzles,  etc.  The  exercises  are  here  to  help 
you  practice  what  you’ve  learned,  and  you  should  do  them  all.  The  puzzles 
are  a different  story,  and  some  of  them  are  quite  challenging  in  a puzzle 
way  These  puzzles  are  meant  for  puzzlersy  and  you  probably  already  know  if 
you  are  one.  If  you’re  not  sure,  we  suggest  you  give  some  of  them  a try,  but 
whatever  happens,  don’t  be  discouraged  if  you  can't  solve  a puzzle  or  if  you 
simply  can't  be  bothered  to  take  the  time  to  work  them  out. 

The  ‘Sharpen  Your  Pencil”  exercises  don't  have  answers. 

Not  printed  in  the  book,  anyway.  For  some  of  them,  there  is  no  right 
answer,  and  for  the  others,  part  of  the  learning  experience  for  the  Sharpen 
activities  is  for  you  to  decide  if  and  when  your  answers  are  right.  (Some  of 
our  suggested  answers  are  available  on  wickedlysman.com) 

The  code  examples  are  as  lean  as  possible 

It’s  frustrating  to  wade  through  200  lines  of  code  looking  for  the  two  lines 
you  need  to  understand.  Most  examples  in  this  book  are  shown  within  the 
smallest  possible  context,  so  that  the  pan  you’re  trying  to  learn  is  clear  and 
simple.  So  don’t  expect  the  code  to  be  robust,  or  even  complete.  That's 
your  assignment  for  after  you  finish  the  book.  The  book  examples  are 
written  specifically  for  learning  and  aren’t  always  fully-functional. 
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chaseCatQ 
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tech  editing:  Jessica  and  Valentin 


Technical  Editors 


"Credit  goes  to  all,  but  mistakes  are  the  sole  reponsibility  of  the 
author...”.  Does  anyone  really  believe  that?  See  the  two  people  on 
this  page?  If  you  find  technical  problems,  it's  probably  *A^rfault-  : 


) 


Jess\M 


Jessica 


Jess  works  at  Hewlett-Packard  on  the  Self- 
Healing  Services  Team.  She  has  a Bachelor  s 
in  Computer  Engineering  from  Villanova 
University,  has  her  SCPj  1.4  and  SCWCD 
certifications,  and  is  literally  months  away 
from  receiving  her  Masters  in  Software 
Engineering  at  Drexel  University  (whew!) 

When  she’s  not  working,  studying  or 
motoring  in  her  MINI  Cooper  S,  Jess  can 
be  found  fighting  her  cat  for  yam  as  she 
completes  her  latest  knitting  or  crochet 
project  (anybody  want  a hat?)  She  is 
originally  from  SaJtLake  City,  Utah  (no, 
she  s not  Mormon...  yes,  you  were  too 
going  to  ask)  and  is  currently  living  near 
Philadelphia  with  her  husband,  Mendra,  and 
two  cats:  Chai  and  Sake. 

You  can  catch  her  moderating  technical 
forums  atjavaranch.com. 


Valentin  Valentin  Crettaz  has  a Masters  degree 
in  Information  and  Computer  Science  from 
the  Swiss  Federal  Institute  of  Technology  in 
Lausanne  (EPFL).  He  has  worked  as  a software 
engineer  with  SRI  International  (Menlo  Park, 
CA)  and  as  a principal  engineer  in  the  Software 
Engineering  Laboratory  of  EPFL. 

Valentin  is  the  co-founder  and  CTO  of  Condris 
Technologies,  a company  specializing  in  the 
development  of  software  architecture  solutions. 

His  research  and  development  interests 
include  aspect-oriented  technologies,  design 
and  architectural  patterns,  web  services,  and 
software  architecture.  Besides  taking  care  of 
his  wife,  gardening,  reading,  and  doing  some 
sport,  Valentin  moderates  the  SCBCD  and 
SCDJWS  forums  atjavaranch.com.  He  holds 
the  SCJP,  SCJD,  SCBCD,  SCWCD,  and  SCDJWS 
certifications.  He  has  also  had  the  opportunity 
to  serve  as  a co-author  for  Whizlabs  SCBCD 
Exam  Simulator. 

(WeTe  still  in  shock  from  seeing  him  in  a tit.) 
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Other  people  to  bWie; 

Ai  O'Reilly: 

Our  biggest  thanks  to  Mike  Loukides  at  O'Reilly,  for  taking  a 
chance  on  this,  and  helping  to  shape  the  Head  First  concept  into 
a book  (and  series) . As  this  second  edition  goes  to  print  there 
are  now  five  Head  First  books,  and  he's  been  with  us  all  the  way. 

To  Tim  CPReilly,  for  his  willingness  to  launch  into  something 
completely  new  and  different.  Thanks  to  the  clever  Kyle  Hart  for 
figuring  out  how  Head  First  fits  into  the  world,  and  for  launching 
the  series-  Finally,  to  Edie  Freedman  for  designing  the  Head  First 
“emphasize  die  head”  cover. 

Our  intrepid  beta  testers  and  reviewer  team: 

Our  top  honors  and  thanks  go  to  the  director  of  our  javaranch 
tech  review  team,  Johannes  de  Jong.  This  is  your  fifth  time  around 
with  us  on  a Head  First  book,  and  we're  thrilled  you’re  still  speaking 
to  us.  Jeff  Cumps  is  on  his  third  book  with  us  now  and  relentless 
about  finding  areas  where  we  needed  to  be  more  clear  or  correct. 

Corey  McGlone,  you  rock.  And  we  think  you  give  the  clearest 
explanations  on  javaranch.  You’ll  probably  notice  we  stole  one  or 
two  of  them.  Jason  Menard  saved  our  technical  butts  on  more 
than  a few  details,  and  Thomas  Paul,  as  always,  gave  us  expert 
feedback  and  found  the  subtle  Java  issues  the  rest  of  us  missed. 
Jane  Griscti  has  her  Java  chops  (and  knows  a thing  or  two  about 
writing)  and  it  was  great  to  have  her  helping  on  the  new  edition 
along  with  long-time  javarancher  Barry  Gaunt 

Marilyn  de  Queiroz  gave  us  excellent  help  on  both  editions  of  the 
book.  Chris  Jones,  John  Nyquist,  James  Cubeta,  Terri  Cubeta, 
and  Ira  Becker  gave  us  a ton  of  help  on  the  first  edition. 

Special  thanks  to  a few  of  the  Head  Firsters  who've  been  helping 
us  from  the  beginning:  Angelo  Celeste,  Mikalai  Zaikin,  and 
Thomas  Duff  (twdufif.com).  And  thanks  to  our  terrific  agent,  David 
Rogeiberg  of  StudioB  (but  seriously,  what  about  the  movie  rights?) 
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still  more  acknowledgements 

Just  when  you  thought  there  wouldn't  be  any 
more  acknowledgements*. 


More Java  technical  experts  who  helped  out  on  the  first  edition  (in  pseudorandom  order): 

Emiko  Hori,  Michael  Taupitz,  Mike  Gallihugh,  Manish  Hatwalne,  James  Chegwidden, 
Shweta  Mathur,  Mohamed  Mazahim,  John  Paverd,  Joseph  Bih,  Skulrat  Patanavanich, 

Sunil  Palicha,  Suddhasatwa  Ghosh,  Ramki  Srinivasan,  Alfred  Raouf,  Angelo  Celeste, 
Mikalai  Zaikin,  John  Zoetebier,  Jim  Pleger,  Barry  Gaunt,  and  Mark  Dielen. 

The  first  edition  puzzle  team: 

Dirk  Schreckmann,  Mary  “JavaCross  Champion”  Leners,  Rodney  J.  Woodruff,  Gavin  Bong, 
and  Jason  Menard.  Javaranch  is  lucky  to  have  you  all  helping  out. 


Other  co-conspirators  to  thank: 

Paul  Wheaton,  the  javaranch  Trail  Boss  for  supporting  thousands  of  Java  learners. 

Solveig  HaugLand,  mistress  of  J2EE  and  author  of  “Dating  Design  Patterns”. 

Authors  Dori  Smith  and  Tom  Negrino  (backupbrain.com),  for  helping  us  navigate  the 
tech  book  world. 

Our  Head  First  partners  in  crime,  Eric  Freeman  and  Beth  Freeman  (authors  of  Head  First 
Design  Patterns),  for  giving  us  the  Bawls™  to  finish  this  on  time. 

Sherry  Dorris,  for  the  things  that  really  matter. 


Brave  Early  Adopters  of  the  Head  First  series: 

Joe  Litton,  Ross  P.  Goldberg,  Dominic  Da  Silva,  honestpuck,  Danny  Bromberg,  Stephen 
Lepp,  Elton  Hughes,  Eric  Christensen,  Vulinh  Nguyen,  Mark  Rau,  Abdulhaf,  Nathan 
Oliphant,  Michael  Bradly,  Alex  Darrow,  Michael  Fischer,  Sarah  Nottingham,  Tim  Allen, 
Bob  Thomas,  and  Mike  Bibby  (the  first). 


*The  large  number  of  acknowledgements  is  because  we’re  testing  the  theory  that  everyone  mentioned  in 
a book  acknowledgement  will  buy  at  least  one  copy,  probably  more,  what  with  relatives  and  everything.  If 
you’d  like  to  be  in  the  acknowledgement  of  our  next  book,  and  you  have  a large  family,  write  to  us. 
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Breaking  the  Surface 


Come  on,  the  water's 
great!  We'll  dive  right  in  and 
write  some  code,  then  compile  and 
run  it.  We’re  talking  syntax,  looping 
and  branching,  and  a look  at  what 
makes  Java  so  cool.  You'll  be 


Java  takes  you  to  new  places.  From  its  humble  release  to  the  public  as  the 
(wimpy)  version  1 .02,  Java  seduced  programmers  with  Its  friendly  syntax,  object-oriented  features, 
memory  management,  and  best  of  all — the  promise  of  portability.  The  lure  of  wrlte-once/run- 
anywhere  is  just  too  strong.  A devoted  following  exploded,  as  programmers  fought  against  bugs, 
limitations,  and,  oh  yeah,  the  fact  that  it  was  dog  slow.  But  that  was  ages  ago.  If  you're  just  starting  in 
Java,  you’re  lucky.  Some  of  us  had  to  walk  five  miles  in  the  snow,  uphill  both  ways  (barefoot),  to 
get  even  the  most  trivial  applet  to  work.  But  you,  why, you  get  to  ride  the  sleeker,  faster,  much 
more  powerful  Java  of  today. 


this  is  a new  chapter 
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the  way  Java  works 


The  Way  Java  Works 

The  goal  is  to  write  one  application  (in  this 
example,  an  interactive  party  Invitation)  and  have 
It  work  on  whatever  device  your  friends  have. 


source  code  for 
the  Interactive 
party  Invitation, 


Source 

O 

Create  a source 
document.  Use  an 
established  protocol 
(In  this  case,  the  Java 
language). 


Compiler 

O 

Run  your  document 
through  a source  code 
compiler.The  compiler 
checks  for  errors  and 
won't  let  you  compile 
until  It's  satisfied  that 
everything  will  run 
correctly. 


Your  friends  don't  have 
a physical  Java  Machine, 
but  they  all  have  a 
ir/rft/d/Java  machine 
(implemented  in 
software)  running  inside 
their  electronic  gadgets. 
The  virtual  machine  reads 
and  runs  the  bytecode. 


Output 

(code) 

O 


The  compiler  creates  a 
new  document,  coded 
into  Java  bytecode. 

Any  device  capable  of 
running  Java  will  be  able 
to  Interpret/translate 
this  file  into  something 
It  can  run.The  compiled 
bytecode  is  platform- 
independent. 


0 aload_0 

1 invokeape- 
clal  #1  ^Method 

java.iang.Ob}ectO> 


4 return 


Virtual 

Machines 


Method  PartyO 
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What  you'll  do  in  Java 

You’ll  type  a source  code  file,  compile  it  using  the 
javac  compiler,  then  run  the  compiled  bytecode 
on  a Java  virtual  machine. 


rporijava.awt\ 

nfxrtiava.awtevenL*; 

3as$Party{ 

I pt^bSc  void  buJIciinvtteO  { 
frame  f=oewFf8me0; 

Label  I = new  LabelfParty  at  Tim's-); 
Sutton  b = new  Button('You  bet): 
Button  c = new  Button(*$hool  me-); 
Panel  p = new  Panelf); 

P^d{l); 

I ) //more  code  here,., 

Source 

O 

Type  your  source  code. 
Save  as;  Party. java 


% javac  Party . java 


Compiler 


Compile  the  Partyjava 
fife  by  running  javac 
(the  compiler  application). 
If  you  don't  have  errors, 
you'll  get  a second  docu- 
ment named  Porty.dass 


Method  PartyO 
0 aloadj) 

1 1nvokespedal  #1  <Mathod 
|ava.lan9.0bjedO> 

4 return 

Method  void  bufldlnviteO 
0 new  #2  <Class  java^wLFrame> 

3 dup 

4 Invokespedal  #3  <Method 
]ava,awlFrameO> 


Output 

(code) 


The  compiler-generated 
Party.class  file  is  made  up 
of  bytecodes. 


o 

Compiled  code:  Party. class 


| Fite  5dk  Window  Help  Swpar  | 


%java  Party 


&&&. — 

party  at  Tim’s? 


Virtual 

Machines 

O 

Run  the  program  by 
starting  the  Java  Virtual 
Machine  (JVM)  with  the 
Party.dass  file.  The  JVM 
translates  the  bytecode 
into  something  the 
underlying  platform 
understands,  and  runs 
your  program. 


(Note;  this  ii  wot  widawfc  to  be  a tutorial...  youll  be 
WYi'tirrf)  real  Ccdt  m a rwo*r.£*t,  but  (or  m>n,  we  juit 
want  you  to  $et  a (tt\  f<w  how  it  all  fits  io^ttbcY.) 
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Classes  in  the  Java  standard  library 


A very  brief  history  of  Java 


OJ 

> 

«3 

o 


2 

M 


3500 

3000 

2500 

2000 

1500 

1000 

500 

Q 


250  classes 


500  classes 


torsions  1.2  - 141 


torsions  1.5  and  op) 


Slow . 

A little  faster. 

2300  classes 

3500  classes 

Cute  name  and  logo. 

More  capable,  friendlier . 

Much  faster . 

More  power,  easier  to 

Fun  to  use.  Lots  of 

Becoming  very  popular 

Can  (sometimes)  run  at 

develop  with. 

bugs.  Applets  are 
the  Big  Thing. 

Better  GUI  code. 

native  speeds.  Serious, 
poweriW.  Comes  in  three 
flavors:  Micro  Edition  (J2ME), 
Standard  Edition  (J2SE)  and 
Enterprise  Edition  (J2EE). 
Becomes  the  language  of 
choice  for  new  enterprise 
(especially  web-based)  and 
mobile  applications. 

Besides  adding  more  than  a 
thousand  additional  classes, 
Java  5.0  (known  as 'Tiger') 
added  major  changes  to 
the  language  itself,  making 
it  easier  (at  least  in  theory) 
for  programmers  and  giving 
it  new  features  that  were 
popular  in  other  languages. 
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o* 

I tee  Java  2 and  Java  5.0,  but  was  there  a Java  3 
and  4?  And  why  Is  it  Java  5.0  but  not  Java  2.0? 

The  joys  of  marketing...  when  the  version  of  Java 
sncfted  from  1 .1  to  1 .2,  the  changes  to  Java  were  so 
dramatic  that  the  marketers  decided  we  needed  a whole 
-ww'nameTso  they  started  calling  It  Jaw  2,  even  though 
actual  version  of  Java  was  1 .2.  But  versions  1 .3  and  1 .4 
were  still  considered  Java 2.  There  never  was  a Java  3 or 
-s. Beginning  with  Java  version  1 .5,  the  marketers  decided 


once  again  that  the  changes  were  so  dramatic  that  a 
new  name  was  needed  (and  most  developers  agreed),  so 
they  looked  at  the  options. The  next  number  In  the  name 
sequence  would  be  "3"  but  calling  Java  1.5  Java  3 seemed 
more  confusing,  so  they  decided  to  name  It  Java  5.0  to 
match  the *5" in  version  "1.5" 

So,  the  original  Java  was  versions  1 .02  (the  first  official 
release)  through  1.1  were  just  "Java”  Versions  1.2, 1.3,  and 
1.4  were  "Java  2"  And  beginning  with  version  1.5,  Java  is 
called  "Java  5.0"  But  you'll  also  see  it  called  "Java  5"  (without 
the".0")  and  "Tiger"  (its  original  code-name).  We  have  no 
idea  what  will  happen  with  the  next  release... 
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why  Java  is  cool 


your  pencil  answers 


Look  how  easy  it 
Is  to  write  Java. 


int  size  - 27; 

String  name  = "Fido"; 

Dog  myDog  - new  Dog (name,  si2e); 
x = size  - 5; 

if  (x  < 15)  myDog.bark(S) ; 

while  (x  > 3 ) { 
royDog.play( ) ; 

> 

int[]  numList  = {2 ,4,6,8}; 

System . out . print ( * Hello" ) ; 

System-out. print("Dogi  " + name); 

String  num  - "8"; 

At  2 = Integer  .par selnt  (num) ; 

try  { 

readTheFile("myFile-txt" ) ; 

> 

catch (FileMotFoundException  ex)  { 

System. out. print ("File  not  found."); 

> 
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Don*t  worry  about  whether  you  understand  any  of  this  yeti 

Everything  here  Is  explained  in  great  detail  In  the  book,  most 
within  the  first  40  pages).  If  Java  resembles  a language  youVe 
used  in  the  past,  some  of  this  will  be  simple.  If  not,  don't  worry 
about  it.  We'll  get  there... 


declare  an  inteyr  variable  named  W and  jive  it  the  value  ll 

declare  a strinj  of  ehara^tew  variable  named  name*  and  jive  ri  the  value  Tido* 
de^bre  a new  Do}  variable  l*yDo}J  ard  mike  the  new  Do}  uinj  name*  and 

subtract  5 ■Prow  2-1  lvalue  of  'iizt)  and  Aniy  it  to  a variable  nAmcd  V 

rf  % (value  of  ID  U leu  than  IS,  tdl  Ok  do*  t©  bark  8 fames 


keep  loop**}  as  lo*}  as  * u jreater  than  1- 

tell  the  to  play  (* Kaiser  THAT  means  fa>  a doy) 

this  looks  like  -the  end  of  the  I oof  — everything  in  { ] a done  in  the  I 


dedbre  a list  of  intejers  variable  WUst*,  and  pvt  1AA8  into  the  list, 
print  out  ttHel!ou~  probably  at  the  e^mand-W 
print  out  “Hello  Fid©*1  (the  value  of  na^e*  is  “Fido*)  at  the  eofw^Jnd-line 
dedire  a dharaeter  string  variable  nun/  and  jive  it  the  value  of  V 
Convert  the  sfarinj  of  dharadters  V*  mto  an  actual  numeric  value  8 


try  to  do  something- -maybe  the  thinj  we're  trymj  isn  t guaranteed  to  work- 
read  a text  file  named  u»yFile-txt*  for  at  least  TR/  to  read  the  file  ■ J 
must  be  the  end  of  the  “thin}!  to  try*/  so  I juen  you  could  try  many  tWjs.. 

this  wsust  be  where  you  find  out  if  the  thmj  you  tried  didn't  work- 

if  the  thin}  we  tried  failed,  print  “File  not  found*  out  at  the  dommAhd- line 
look*  like  everythin}  in  the  { ] is  what  to  do  if  the  'try'  didn't  work... 


dive  In  A Quick  Dip 


Code  structure  in  Java 


class 


method  2 

statement 

statement 


What  goes  in  a 

source  file? 

A source  code  file  (with  the  Java 
extension)  holds  one  class  defini- 
tion. The  class  represents  a piece 
of  your  program,  although  a very 
tiny  application  might  need  just 
a single  class.  The  class  must  go 
within  a pair  of  curly  braces. 


Put  a class  in  a source  file. 
Put  methods  in  a class. 

Put  statements  in  a method. 


What  goes  in  a 

class? 

A class  has  one  or  more  methods. 
In  die  Dog  class,  the  bark  method 
will  hold  instructions  for  how  the 
Dog  should  bark.  Your  methods 
must  be  declared  inside  % class 
(in  other  words,  within  the  curly 
braces  of  the  class). 


What  goes  in  a 

method? 

Within  the  curly  braces  of  a 
mediod,  write  your  instructions 
for  how  that  method  should  be 
performed.  Method  code  is  basi- 
cally a set  of  statements,  and  for 
now  you  can  think  of  a method 
kind  of  like  a function  or  proce- 
dure. 


public  class  Dog  { 


class! 


public  class  Dog  { 

void  bark  ()  { 

) 

method 


public  class  Dog  { 
void  bark!)  { 

statement!; 
statements  ; 

) 

statements 


you  are  here  ► 
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a Java  class 


Anatomy  of  a class 

When  the  JVM  starts  running,  it  looks  for  the  class  you  give  it  at  the  com- 
mand line.  Then  it  starts  looking  for  a specially-written  method  that  looks 
exacdy  like: 

public  static  void  main  (String [)  args)  ( 

//  your  code  goes  here 

1 

Next,  the  JVM  runs  everything  between  the  curly  braces  { } of  your  main 
method.  Every  Java  application  has  to  have  at  least  one  class,  and  at  least 
one  mam  method  (not  one  main  per  class;  just  one  main  per  application) . 


tan  ittta  it 


this  is  0 
daw  (dwh) 


this  £|dis 


opening  Cwly  brace 
<k  the  class 

public  ] jclass||MyFirstApp:  | 


/ 


f the  return  type-  w ^ 

(well  Cover  this  vouj[  ^ns  here's  array  will  be 

ore  later-)  no  retvrn  value-  ">cthod 


argument,  to 

TV*  method  must  be  given 


Jh  Strings,  and  the 

Ml'ed  'args*  ^ 


l 


public  static]  void  |main  (String  []  args)|  Wf' 


System,  out  .print  ("I  Rule ! ")  |; 

tKis  say*  print  to  standard  output 
(de-faults  to  tofrvmand-line) 

the  String  you 

|^}\  elosmj  trade  of  t be  »a'm  »etbod 

want  to  print 

.ever'f s 


tatemc 


vt  MUST 


end  m a 


;ito\o 


^losinj  braee  of  the  MyFlrstApp  fclass 


Don*t  worry  about  *eiworixj*j  anything  right  now... 
tk»s  ebaptev  d just  to  jet  you  started- 
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Writing  a class  with  a main 

In  Java,  everything  goes  in  a class.  You’ll  type  your  source  code  file  (with  a 
.java  extension),  then  compile  it  into  a new  class  file  (with  a .class  extension). 
When  you  run  your  program,  you’re  really  running  a class. 

Running  a program  means  telling  the  Java  Virtual  Machine  (JVM)  to  “Load  the 
Hello  class,  then  start  executing  its  main  ( ) method-  Keep  running  ‘til  all  the 
code  in  main  is  finished.” 

In  chapter  2,  we  go  deeper  into  the  whole  doss  thing,  but  for  now,  all  you  need  to 
think  is,  how  do  I write Java  code  so  that  it  win  runt  And  it  all  begins  with  mam(). 

The  main()  method  is  where  your  program  starts  running. 

No  matter  how  big  your  program  is  (in  other  words,  no  matter  how  many  classes 
your  program  uses),  there's  got  to  be  a main()  method  to  get  the  ball  rolling. 


wry 


MyFIrstApp.class 


public  class  MyFirstApp  { 

public  static  void  main  (String[]  args)  { 
Sysban.out.println ("I  Buie!"); 

System. out. prin tin  ("The  World") ; 

) 


Q Save 

MyFirstApp  .java 

0 Compile 

javac  MyFirstApp. java 

©Run 

| File  Edit  Window  Help  Scream  | 


% java  MyFirstApp 
1 Rule! 

The  World 


you  are  here  ► 
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statements,  looping,  branching 


* Each  statement  must  end  in  a 
semicolon. 


Q do  something  again  and  again 

Loop*:  to/- and  while 


Syntax 
Fun 


What  can  you  say  in  the  main  method? 

Once  you're  inside  main  (or  any  method),  the  fun 
begins.  You  can  say  ail  the  normal  things  that  you  say 
in  most  programming  languages  to  make  the  computer 
do  something . 

Your  code  can  tell  the  JVM  to: 

Q do  something 

Statements:  declarations,  assignments, 
method  calls, etc. 

int  x = 3; 

String  name  = "Dirk"; 
x-x*17; 

System . out .print ("x  is  " + x) ; 
double  d = Math . random () ; 

//  this  is  a comment 


for  (int  x = 0;  x < 10;  x = x + 1)  { 

System. out .print  ("x  is  now  " + x)  ; 

} 


x * x + i ; 

* A single-line  comment  begins 
with  two  forward  slashes. 


Q do  something  under  this  condition 

Branching:  ff/efse  tests 
if  (x  ==  10)  ( 

System. out . print <"x  must  be  10"); 

} else  { 

System. out. print("x  isn't  10"); 

) 

if  ((x  < 3)  & (name. equals ("Dirk")  ) ) ( 

System . out .print In ( "Gently" ) ; 

) 

System. out .print ("this  line  runs  no  matter  what"); 


x « 22; 

//  this  line  disturbs  ms 

Most  white  space  doesn't  matter, 
x = 3 ; 

* Variables  are  declared  with  a 
name  and  a type  (you'll  learn  about 
all  the  Java  types  In  chapter  3). 

int  weight; 

//type;  int , name;  weight 

* Classes  and  methods  must  be 
defined  within  a pair  of  curly  braces. 

public  void  go ( ) { 

//  amazing  code  here 

} 
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while  (moreBalls  =-  true)  { 


JkeepJugglingQ; 

) 

bfc 


Looping  and  looping  and... 

Java  has  three  standard  looping  constructs;  while, 
dtxukile , and  for.  You'll  get  the  full  loop  scoop  later 
in  the  book,  but  not  for  awhile,  so  let's  do  while  far 
now. 

The  syntax  (not  to  mention  logic)  is  so  simple 
you’re  probably  asleep  already.  As  long  as  some 
condition  is  true,  you  do  everything  inside  the 
loop  block.  The  loop  block  is  bounded  by  a pair  of 
curly  braces,  so  whatever  you  want  to  repeat  needs 
to  be  inside  that  block. 

The  key  to  a loop  is  the  conditional  UsL  In  Java,  a 
conditional  test  is  an  expression  that  results  in  a 
boolean  value — in  other  words,  something  that  is 
either  true  or  false . 

If  you  say  som edging  like,  “While  iceCreamlnTheTub 
is  true,  keep  scooping*,  you  have  a clear  boolean 
test.  There  either  is  ice  cream  in  the  tub  or  there 
isn't  But  if  you  were  to  say,  “While  Bob  keep 
scooping”,  you  don’t  have  a real  test.  To  make 
that  work,  you'd  have  to  change  it  to  something 
like,  "While  Bob  is  snoring...*  or  "While  Bob  is  not 
wearing  plaid...” 


Simple  boolean  tests 

You  can  do  a simple  boolean  test  by  checking 
the  value  of  a variable,  using  a comparison  operator 
including: 

< (less  than) 

> (greater  than) 

= (equality)  (yes,  that's  two  equals  signs) 

Notice  the  difference  between  the  assignment 
operator  (a  single  equals  sign)  and  the  equals 
operator  (two  equals  signs).  Lots  of  programmers 
accidentally  type  * when  they  want  (But  not 
you.) 

int  x = 4;  / / assign  4 to  x 
while  (x  > 3)  { 

If  loop  code  will  run  because 

//  x is  greater  than  3 

x = x - 1;  //or  we'd  loop  forever 

1 

int  2=27;  // 
while  (z  ==■  17)  { 

//  loop  code  will  not  run  because 
//  z is  not  equal  to  17 


you  are  here  ► 
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Java  basics 


T 


Q/  Why  does  everything  have 
to  be  in  a class? 


Java  is  an  object-oriented 
(00)  language.  It's  not  like  the 
old  days  when  you  had  steam- 
driven  compilers  and  wrote  one 
monolithic  source  file  with  a pile 
of  procedures.  In  chapter  2 you'll 
learn  that  a class  is  a blueprint  for 
an  object,  and  that  nearly  every- 
thing in  Java  is  an  object. 


% Do  I have  to  put  a main  In 
every  class  I write? 


A: 


Nope.  A Java  program 
might  use  dozens  of  classes  (even 
hundreds),  but  you  might  only 
have  one  with  a main  method — 
the  one  that  starts  the  program 
running. You  might  write  test 
classes,though,that  have  main 
methods  for  testing  your  other 
classes. 


Q In  my  other  language  I can 
do  a boolean  test  on  an  Integer. 
In  Java,  can  I say  something  like: 

int  x = 1 ; 

while  (x)(  > 


A: 


No,  A boolean  and  an 
integer  are  not  compatible  types  In 
Java.  Since  the  result  of  a condi- 
tional test  must  be  a boolean,  the 
only  variable  you  can  directly  test 
(without  using  a comparison  op- 
erator) Is  a 6oo/eon.  For  example, 
you  can  say: 

boolean  isHot  » true; 
while (iaHot)  { ) 


Example  of  a while  loop 

public  class  Loopy  { 

public  static  void  main  (StringH  args)  { 
int  x = 1; 

System. out .println ("Before  the  Loop"); 
while  (x  < 4)  ( 

System, out . println ("In  the  loop") ; 

System, out, println ("Value  of  x is  " + x) ; 
x = x + 1; 

) 

System,  out.  println  (vvThis  is  after  the  loop"); 


} 


} 

% java  Loopy 
Before  the  Loop 
In  the  loop 
Value  of  x ia  1 
In  the  loop 
Value  of  x ia  2 
In  the  loop 
Value  of  x ia  3 
This  ia  after  the 


loop 


BULLET 

■ Statements  end  in  a semicolon ; 

■ Code  blocks  are  defined  by  a pair  of  curly  braces  { } 

■ Declare  an  ini  variable  with  a name  and  a type:  Int  x; 

■ The  assignment  operator  Is  one  equals  sign  9 

■ The  equals  operator  uses  two  equals  signs  == 

■ A while  loop  runs  everything  within  its  block  {defined  by  curly 
braces)  as  long  as  the  conditional  test  Is  true. 

• If  the  conditional  test  is  false , the  while  loop  code  block  won’t 
run,  and  execution  will  move  down  to  the  code  immediately 
after  the  loop  block. 

■ Pul  a boolean  test  Inside  parentheses; 
while  (x  = 4)  ( } 
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Conditional  branching 

In  Java,  an  if  test  is  basically  the  same  as  the  boolean  test  in  a 
xhiU  loop  - except  instead  of  saying, u while  there's  still  beer...”, 
voull  say,  “if  there's  still  beer...” 

class  If Test  { 

public  static  void  main  (String []  args)  { 
int  x = 3; 
if  (x  = 3)  ( 

System. out. println ("x  must  be  3"); 

} 

System. out .println ("This  runs  no  matter  what"); 


I java  IfTaat  , 

x must  be  3 

This  runs  no  matter  what 


*edt 


The  code  above  executes  the  line  that  prints  ux  must  be  3”  only 
if  the  condition  (xis  equal  to  3)  is  true.  Regardless  of  whether 
it’s  true,  though,  the  line  that  prints,  “This  runs  no  matter  what” 
will  run.  So  depending  on  the  value  of  x,  either  one  statement 
or  two  will  print  out 

But  we  can  add  an  else  to  the  condition,  so  that  we  can 
say  something  like,  “If  there's  still  beer,  keep  coding,  else 
(otherwise)  get  more  beer,  and  then  continue  on...” 

class  IfTest2  { 

public  static  void  main  (String ()  args)  ( 
int  x = 2; 
if  (x  " 3)  { 

System. out .println ("x  must  be  3"); 

} else  { 

System.out .println ("x  is  NOT  3"); 

) 

System.out .println ("This  runs  no  matter  what") ; 


) 


) 


outyu'k 


Syitew.out.priWf  vs. 
System.out.prlirtin 

If  you've  been  paying  attention  (of 
course  you  have)  then  you've  noticed  us 
switching  between  print  and  println. 

Did  you  spot  the  difference? 

System .out^r/nf In  inserts  a newline 
(think  of  println  as  prfntnewline  while 
SystemiQutpWnr  keeps  printing  to 
the  same  line.  If  you  want  each  thing 
you  print  out  to  be  on  Its  own  iine,  use 
println.  If  you  want  everything  to  stick 
together  on  one  line,  use  print. 


d^tirpen  your  pencil 


Given  the  output: 

% java  DooBee 
DooBeeDooBeaDo 


FiU  in  the  missing  code: 

public  class  DooBee  { 
public  static  void  main  (StringQ  args)  { 
intx  = 1; 

while  (x  < ) ( 

System.out. ("Doo"); 

System.out. ("Bee"); 

x = x+  1; 

) 

lf(*== )( 

System.out.print(*Do*); 

1 

) 

} 


% java  IfTest2  . 
X ia  NOT  3 < 
Thia  runs  no  matter  what 


you  are  here  ► 
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serious  Java  app 


Coding  a Serious  Business 
Application 

Let's  put  all  your  new  Java  skills  to  good  use  with 
something  practical*  We  need  a class  with  a main(),  an  int 
and  a String  variable,  a while  loop,  and  an  i/test  A little 
more  polish,  and  you'll  be  building  that  business  back- 
end in  no  time*  But  before  yon  look  at  the  code  on  this 
page,  think  for  a moment  about  how  you  would  code  that 
classic  children’s  favorite,  “99  bottles  of  been” 


public  class  BeerSong  { 

public  static  void  main  (String!]  args)  ( 
int  beerNum  = 99; 

String  word  - "bottles"; 

while  (beerNum  > 0)  { 

if  (beerNum  ==1)  { 

word  10  "bottle";  //  singular,  as  in  ONE  bottle. 

) 

System* out .println (beerNum  + " " + word  + " of  beer  on  the  wall"); 
System.out.println (beerNum  + " " + word  + " of  beer*"); 

System. out -println ("Take  one  down."); 

System. out .println  ("Pass  it  around."); 
beerNum  - beerNum  - 1; 

if  (beerNum  >0)  { 

System. out  .println  (beerNum  + * " + word  +■  " of  beer  on  the  wall") 
} else  ( 

System . out .println ("No  more  bottles  of  beer  on  the  wall") ; 

} / J end  else 
} //  end  while  loop 
} //  end  main  method 
} //  end  class 


There's  still  one  little  flaw  In  our 
code.  It  complies  and  runs,  but  the 
output  Isn't  1 00%  perfect  See  if 
you  can  spot  the  flaw  , and  fix  It. 
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Monday  morning  at  Bob's 


Bob's  alarm  dock  rings  at  8:30  Monday  morning,  just  like  every  other  weekday 
But  Bob  had  a wild  weekend,  and  reaches  for  the  SNOOZE  button 
And  that’s  when  the  action  starts,  and  the  Java-enabled  appliances 
come  to  life. 

First,  the  alarm  dock  sends  a message  to  the  coffee  maker*  “Hey  the  geek’s 
sleeping  in  again,  delay  the  coffee  12  minutes.'1 

The  coffee  maker  send s a message  to  the  Motorola™ 
toaster,  “Hold  the  toast,  Bob’s  snoozing.” 

The  alarm  clock  then  sends  a message  to  Bob's 
Nokia  Navigator™  cell  phone,  “Call  Bob’s  9 
o’clock  and  tell  him  we're  running  a little  late,” 

Finally  die  alarm  clock  sends  a message  to 
Sam’s  (Sam  is  the  dog)  wireless  collar,  with  the  too-familiar  signal  that 
means,  “Get  the  paper,  but  don’t  expect  a walk.” 

A few  minutes  later,  the  alarm  goes  off  again.  And  again  Bob  T 

hits  SNOOZE  and  the  appliances  start  chattering  Finally,  | * 

the  alarm  rings  a third  time.  But  just  as  Bob  reaches  for  the 
snooze  button,  the  dock  sends  the  “jump  and  bark”  signal  to  Sam’s 
collar.  Shocked  to  full  consciousness,  Bob  rises,  grateful  that  his  Java 
skills  and  a little  trip  to  Radio  Shack™  have  enhanced  the  daily 
routines  of  his  life. 

bu-tteir  here 

His  toast  is  toasted . 

His  coffee  steams . 

His  paper  awaits. 

Just  another  wonderful  morning  in  The  Java-Enabled  House . 


Java  here  bx> 


4 tM 


You  can  have  a Java-enabled  home.  Stick  with  a sensible  solution  using  Java, 
Ethernet,  and  Jini  technology.  Beware  of  imitations  using  other  so-called  ‘*p)ug 
and  play”  (which  actually  means  “plug  and  play  with  it  for  the  next  three  days 
trying  to  get  it  to  work”)  or  “portable”  platforms.  Bob’s  sister  Betty  cried  one  of 
those  others , and  the  results  were,  well,  not  very  appealing  or  safe. 

Bit  of  a shame  about  her  dog  too... 


Could  this  story  be  true?  Yes  and  no.  While  there  are  versions  of  Java  running  in  de- 
vices Including  PDAs,  cell  phones  (especially  cell  phones),  pagers,  rings,  smart  cards, 
and  more  -you  might  not  find  a Java  toaster  or  dog  collar.  But  even  if  you  can't 
find  a Java-enabled  version  of  your  favorite  gadget,  you  can  still  run  it  as  if  it  were  a 
Java  device  by  controlling  it  through  some  other  Interface  (say, your  laptop)  that  is 
running  Java.Tbls  Is  known  as  the  Jini  surrogate  architecture.  Yes  you  can  have  that 
geek  dream  home. 

m!P  multicast  If  you're  gonna  be  all  picky  about  protocol 


you  are  here  ► 


15 


let’s  write  a program 


public  class  Fhr&seOf&tic  { 

public  static  void  main  (Stringd  args)  { 


OK,  so  the  beer  song  wasn't  really  a serious 
business  application.  Still  need  something 
practical  to  show  the  boss?  Check  out  the 
Phrase-O-Matic  code. 


//  male*  three  sets  of  words  to  choose  from.  Add  your 

String  []  wordListOne  = ("24/7", "multi - 
Tier" , "30 , 000  foot" , "B-to-B"  # "win-win" , " front- 
end",  "web-based", "pervasive",  "smart",  "six- 
sigma",  "critical -path",  "dynamic"}; 


String[]  wordListTwo  = ("empowered",  "sticky", 
"value-added" , "oriented",  "centric",  "distributed", 
"clustered" , "branded" , "outs Ida- the -box" , "positioned 
"networked",  "focused",  "leveraged",  "aligned", 
"targeted",  "shared",  "cooperative",  "accelerated"}; 

String []  wordListThree  = ("process",  "tipping- 
point",  "solution",  "architecture",  "core  competency" 
"strategy",  "minds hare",  "portal",  "space",  "vision", 
"paradigm",  "mission"} ; 


vi  do*’±  w a*  ^7  ^ iy?e  ^ 

yo“  » si^  **^1  AFrtz 


o 


o 


//  find  out  bow  many  words  are  In  each  Rst 

int  oneLength  = wordListOne, length; 
int  twoLength  = wordListTwo. length; 
int  threeLength  = wordListThree. length; 

//  generate  three  random  numbors 

int  randl  =»  (int)  (Math . random  ( ) * oneLength); 

int  rand2  = (int)  (Math. random ()  * twoLength); 

int  rand3  = (int)  (Math. random ()  * threeLength) 


//  now  build  a phrase 

String  phrase  = wordListOne [randl]  + " " + 
wordListTwo [rand2]  + " " + wordListThree [ran d3] ; 

//  print  out  Hie  phrase 

System, out. pr intin ( "What  we  need  is  a " + phrase) 

} 
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Phrase-O-Matic 

low  it  work*. 

Is  a nutshell*  the  program  makes  three  lists  of  words,  then  randomly  picks  one  word 
from  each  of  the  three  lists;  and  prints  out  the  result-  Don’t  worry  if  you  don’t  under- 
stand exactly  what’s  happening  in  each  line.  For  gosh  sakes,  you’ve  got  the  whole  book 
ahead  of  you,  so  relax.  This  is  just  a quick  look  from  a 30,000  foot  outside-the-box 
targeted  leveraged  paradigm. 


The  first  step  is  to  create  three  String  arrays  - the  containers  that  will  hold  all  the 
words.  Declaring  and  creating  an  array  is  easy;  here’s  a small  one: 

SWing[]  pots  « {"Fido",  "Zeus",  "Bin"}; 

Each  word  is  in  quotes  (as  all  good  Strings  must  be)  and  separated  by  commas. 


For  each  of  the  three  lists  (arrays),  the  goal  is  to  pick  a random  word,  so  we  have 
x>  know  how  many  words  are  in  each  list  If  there  are  14  words  in  a list,  then  we  need 
a random  number  between  0 and  13  (Java  arrays  are  zero-based,  so  the  first  word  is  at 
poarion  0,  the  second  word  position  1,  and  the  last  word  is  position  13  in  a 14-element 
array).  Quite  handily,  a Java  array  is  more  than  happy  to  tell  you  its  length.  You  just 
ban*  to  ask.  In  the  pets  array,  we’d  say 

in  x = pets. length; 

md  x would  now  hold  the  value  3. 


what  we  need 
here  Is  a... 


pervasive  targeted 
process 


3*  We  need  three  random  numbers,  Java  ships  out-of-the-box,  off-the-shelf,  shrink- 
wrapped,  and  core  competent  with  a set  of  math  methods  (for  now,  think  of  them  as 
EEraetions).  The  random  ( ) method  returns  a random  number  between  0 and  not- 
qmie-1,  so  we  have  to  multiply  it  by  the  number  of  elements  (the  array  length)  in  the 
Sat  we’re  using.  We  have  to  force  the  result  to  be  an  integer  (no  decimals  allowed!)  so 
we  put  in  a cast  (you’ll  get  the  details  in  chapter  4) . It’s  the  same  as  if  we  had  any  float- 
ing point  number  that  we  wanted  to  convert  to  an  integer 

ist  x * (int)  24.6; 

Now  we  get  to  build  the  phrase,  by  picking  a word  from  each  of  the  three  lists, 
and  smooshing  them  together  (also  inserting  spaces  between  words).  We  use  the  “+n 
operator,  which  concatenates  (we  prefer  the  more  technical  'swooshes')  the  String  objects 
together.  To  get  an  element  from  an  array,  you  give  the  array  the  index  number  (posi- 
tion) of  the  thing  you  want  using: 

String  s = potsfO];  //  s is  now  tho  String  "Fido" 
s * s + " " + "is  a dog";  //  s is  now  "Fido  is  s dog" 


dynamic  outside- 
the-box  tipping- 
point 


smart  distributed 
core  competency 


24/7  empowered 
mindshare 


30,000  foot  win-win 
vision 


sfx-sigma  net- 
worked portal 


5 


• Finally,  we  print  the  phrase  to  the  command-line  and...  voila!  We're  in  marketing. . 
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the  compiler  and  the  JVM 


Fireside  Chats 


Tonight's  Talk:  The  compiler  and 
the  JVM  battle  over  the  question, 
“Who’s  more  important?” 


The  Java  Virtual  Machine  The  Compiler 

What,  are  you  kidding?  HELLO.  I awjava. 

I’m  the  guy  who  actually  makes  a program 
run.  The  compiler  just  gives  you  a file.  That’s 
it.  Just  a file.  You  can  print  it  out  and  use  it 
for  wall  paper,  kindling,  lining  the  bird  cage 
what  ever,  but  the  file  doesn't  do  anything  un- 
less I'm  there  to  run  it 

I don’t  appreciate  that  tone. 

And  that's  another  thing,  the  compiler  has 
no  sense  of  humor.  Then  again,  if  you  had  to 
spend  ail  day  checking  nit-picky  little  syntax 

violations...  Excuse  me,  but  without  me , what  exactly 

would  you  run?  There’s  a reason  Java  was 
designed  to  use  a bytecode  compiler,  for  your 
information.  If  Java  were  a purely  interpreted 
language,  where— at  runtime — the  virtual 
machine  had  to  translate  straight-from-a- text- 
editor  source  code,  a Java  program  would 
run  at  a ludicrously  glacial  pace.  Java's  had  a 
challenging  enough  time  convincing  people 
that  it's  finally  fast  and  powerful  enough  for 

I'm  not  saying  you're,  like,  completely  useless.  most  jobs. 

But  really,  what  is  it  that  you  do?  Seriously.  I 
have  no  idea.  A programmer  could  just  write 
bytecode  by  hand,  and  I'd  take  it.  You  might 
be  out  of  a job  soon,  buddy. 

Excuse  me,  but  that's  quite  an  ignorant  (not 
to  mention  arrogant)  perspective.  While  it 
is  true  that—  theoretically — you  can  run  any 
properly  formatted  bytecode  even  if  it  didn’t 
come  out  of  a Java  compiler,  in  practice  that's 
absurd.  A programmer  writing  bytecode  by 
hand  is  like  doing  your  word  processing  by 
writing  raw  postscript.  And  I would  appreciate 

. . . . x _ it  if  you  would  not  refer  to  me  as  “buddy." 

(I  rest  my  case  on  the  humor  thing.)  But  you 

still  didn't  answer  my  question,  what  do  you 

actually  do? 
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dive  In  A Quick  Dip 


The  Java  Virtual  Machine 


But  some  still  get  through!  I can  throw  Class- 
CastExceptions  and  sometimes  I get  people 
trying  to  put  the  wrong  type  of  thing  in  an 
array  that  was  declared  to  hold  something 
else,  and — 


OK  Sure.  But  what  about  security ? Look  at  all 
the  security  stuff  I do,  and  you’re  like,  what, 
checking  for  semicolons P Oooohhh  big  security 
risk!  Thank  goodness  for  you! 


Whatever.  I have  to  do  that  same  stuff  too , 
though,  just  to  make  sure  nobody  snuck  in 
after  you  and  changed  the  bytecode  before 
running  it. 


Oh,  you  can  count  on  it.  Buddy . 


The  Compiler 

Remember  that  Java  is  a strongly-typed  lan- 
guage, and  that  means  I can’t  allow  variables 
to  hold  data  of  the  wrong  type.  This  is  a 
crucial  safety  feature,  and  I'm  able  to  stop  the 
vast  majority  of  violations  before  they  ever  get 
to  you.  And  I also — 


Excuse  me,  but  I wasn’t  done.  And  yes,  there 
are  some  datatype  exceptions  that  can  emerge 
at  runtime,  but  some  of  those  have  to  be 
allowed  to  support  one  of  Java’s  other  impor- 
tant features — dynamic  binding.  At  runtime, 
a Java  program  can  include  new  objects  that 
weren’t  even  known  to  the  original  program- 
mer, so  I have  to  allow  a certain  amount  of 
flexibility.  But  my  job  is  to  stop  anything  that 
would  never — could  never — succeed  at  run- 
time. Usually  I can  tell  when  something  won’t 
work,  for  example,  if  a programmer  acciden- 
tally tried  to  use  a Button  object  as  a Socket 
connection,  I would  detect  that  and  thus 
protect  him  from  causing  harm  at  runtime. 

Excuse  me,  but  I am  the  first  line  of  defense, 
as  they  say.  The  datatype  violations  I previous- 
ly described  could  wreak  havoc  in  a program 
if  they  were  allowed  to  manifest.  I am  also 
the  one  who  prevents  access  violations,  such 
as  code  trying  to  invoke  a private  method,  or 
change  a method  that  - for  security  reasons 
- must  never  be  changed.  I stop  people  from 
touching  code  they’re  not  meant  to  see, 
including  code  trying  to  access  another  class’ 
critical  data.  It  would  take  hours,  perhaps  days 
even,  to  describe  the  significance  of  my  work. 

Of  course,  but  as  I indicated  previously,  if  I 
didn’t  prevent  what  amounts  to  perhaps  99%  * 

of  the  potential  problems,  you  would  grind  to 
a halt.  And  it  looks  like  we’re  out  of  time,  so 
we’ll  have  to  revisit  this  in  a later  chat. 
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exercise:  Code  Magnets 


SBUOTECA 


Code  Magnets 

A working  Java  program  is  all  scrambled  up 
on  the  fridge.  Can  you  rearrange  the  code 
snippets  to  make  a working  Java  program 
that  produces  the  output  listed  below? 
Some  of  the  curly  braces  fell  on  the  floor 
and  they  were  too  small  to  pick  up,  so  feel 
free  to  add  as  many  of  those  as  you  need! 


/f 

/|CAHPUS^ 
c ESTADO 
\t  DE  S/ 
V'  mcxico  , 


ffc*  L*  WVidCM  Mp 


% java  Shufflel 
a-b  c-d 


dive  In  A Quick  Dip 


BE  the  compiler 


Each  of  ike  Java  flies  on  this  page 
represents  a complete  source  file. 
Your  job  is  to  play  compiler  and 
determine  whether  each  of  these 

files  will  compile.  If  they 
won’t  compile,  how 
would  you  fix  them? 


6 

public  static  void  main($tring  []  args)  { 
int  x = 5; 
while  ( x > 1 ) { 
x = x - 1; 
if  ( x < 3)  { 

System. out. println^small  x"); 

} 

) 


A 

class  Exerciselb  { 

public  static  void  main(String  []  args)  { 
int  x = 1; 
while  ( x < 10  ) { 
if  < x > 3)  < 

System. out. println(“big  x"); 

> 

) 

> 


c 

class  Exerciselb  { 
int  x - 5; 
while  < x > 1 ) { 
x = x - i; 
if  ( x < 3)  { 

System. out. println^small  x*); 

) 

) 
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puzzle:  crossword 


JavaCMSS  7.0 

Let's  give  your  right  brain  something  to  do. 

It's  your  standard  crossword  but  almost  all 
of  the  solution  words  are  from  chapter  1 Just 
to  keep  you  awake,  we  also  threw  in  a few 
(non-Java)  words  from  the  high-tech  world. 


Across 

4.  Command-line  invoker 
6.  Back  again? 

8.  Can't  go  both  ways 

9.  Acronym  for  your  laptop's  power 

12.  number  variable  type 

13.  Acronymforachlp 

1 4.  Say  something 

1 8.  Quite  a crew  of  characters 

1 9.  Announce  a new  class  or  method 
2 1 . What's  a prompt  good  for? 


Down 

1 . Not  an  integer  (or your  boat) 

2.  Come  back  empty-handed 

3.  Open  house 

5.  Things'  holders 
7.  Until  attitudes  improve 

10.  Source  code  consumer 

1 1.  Can't  pin  it  down 
13.  Dept,  of  LAN  jockeys 

15.  Shocking  modifier 

16.  Just  gotta  have  one 

1 7.  How  to  get  things  done 

20.  Bytecode  consumer 
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dive  In  A Quick  Dip 


Mixed 

Messages 


A short  Java  program  Is  listed  below.  One  block  of  the  program 
is  missing.  Your  challenge  is  to  match  the  candidate  block  of 
code  (on  the  left),  with  the  output  that  you'd  see  if  the  block 
were  inserted.  Not  all  the  lines  of  output  will  be  used,  and  some 
of  the  lines  of  output  might  be  used  more  than  once.  Draw  lines 
connecting  the  candidate  blocks  of  code  with  their  matching 
command-line  output.  (The  answers  are  at  the  end  of  the  chapter). 


Candidates;  Possible  output: 


if ( y > 4 ) { 
y = y - i; 

> 


x = x + 1; 
y « y + x; 

if  ( y < 5 ) { 
x = x + If 
if  ( y < 3 ) { 
x = x - If 

> 

> 

y o y + 2f 
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puzzle:  Pool  Puzzle 


P««l  P UZz]t 


Your  job  is  to  take  code  snippets  from  the 
pool  and  place  them  Into  the  blank 
lines  in  the  code.  You  may  not  use  the 
same  snippet  more  than  once, and 
you  won't  need  to  use  all  the  snip- 
pets. Your  goal  is  to  make  a class  that 
will  compile  and  run  and  produce  the 
output  listed.  Don't  be  fooled — this  one's 
harder  than  it  looks. 


class  PoolP\i22leOne  { 

public  static  void  main (String  [1  args)  { 
int  x - 0; 

while  ( ) { 


if  ( x < 1 ) { 


> 


if  ( ) { 


Output 


> 


System,out.print{"noys  "); 
System.out.print(*olse*); 
System.out.print(u  oyster"); 
System.out.prmtrannoys"); 
System.out.p^int^noise',); 


System. out. prlnt("  "); 
System.out.printra"); 
System.outprintrn  "); 
System,  out,prlnt("an"); 


Note:  Each  snippet 
from  the  pool  can  be 
used  only  oncel 


x>  0 

x<  1 

X > t 

x > 3 

X = x+  1, 

x < 4 

x = x + 2, 

X 

11 

X 

ro 

X = X - 1; 

I nia  £dh  Window  Help  Cheal 


%java  PoolPuzzleOne 


a noise 


annoys 


an  oyster 


> 

System. out. print 1 n("") ; 
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Exercise  Solutions 


Cede  Magnets: 

class  Shuffle  1 { 

public  static  void  main (String  []  args)  { 

int  x » 3; 
while  (x  > 0)  { 

if  (x  > 2 ) { 

System,  out  * print  ( "a") ; 

> 

X = x - 1 ; 

System. out  .print  ( iJ-"  ) ; 

if  (x  ==  2)  < 

System. out. print ( "h  C); 

> 

if  (x  ==  1)  { 

System. out .print ( "d") ; 
x = x - 1; 

> 

> 


java  Shufflel 
a-b  c-d 


dive  In  A Quick  Dip 

class  Exerciselb  { 

public  static  void  main(String  []  args)  { 
int  x = 1, 
while  ( x < 10  ) { 

X = X + 1; 
if  ( x > 3)  { 

System. out. println( "big  x"); 

I 

> 

} This  will  compile  and  run  (no  output),  but 
> without  a line  added  to  the  program,  it 

would  run  forever  in  an  infinite  'while'  loop) 


class  Foo  { 

public  static  void  main(String  []  args)  { 
int  x = 5; 
while  < x > 1 ) { 
x = x - 1; 

B if  ( x < 3)  { 

System. out. printlnf "small  x"); 

) 

} This  file  won't  compile  without  o 
} class  declaration,  and  don't  forget 
} the  matching  curly  brace  I 


class  Exerciselb  { 


public  static  void  n\ain(5tring  []  args)  { 

int  x = S) 
while  ( x > 1 ) ( 

X ■ X - 1; 

C it  ( x < 3)  { 

System. out .printing" small  x* ) ; 

> 

* The  while'  loop  code  must  be  in- 
' side  a method.  It  can't  just  be 
) hanging  out  inside  the  class, 
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puzzle  answers 


class  PoolPuzzleOne  { 

public  static  void  main(String  (]  args)  { 
int  x = 0; 

while  ( X < 4 ) { 

System  .out . prlntf 'a"): 

if  ( x < 1 ) < 

System.out.printf  ”); 

} 

System  .out . prlntf  n"); 

if  ( X > 1 ) { 

System,  out.  prlntf*  oyster").' 
x = x ♦ 2; 

> 

if  ( x ==  1 ) { 

System,  out.  pH  rrtfnoys"); 

} 

if  ( X < 1 > { 

System . out.  prlntf  olse"); 

> 

System. out. println("") ; 


X = X ♦ 1; 

> 

> 

> 


rtrn  Ml  W*-op»  rws 


^java  Pool Puzz leone 
a noise 
annoys 
an  oyster 


class  Test  { 

public  static  void  main (String  M argsj  ( 
int  x = 0; 
int  y - 0; 
while  ( x < 5 ) f 


System .out .print [x  + + y ") ; 

x = x + 1; 

) 

) 


Candidate!  PojsJbl*  output: 


y * y + 2J| 
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2 classes  and  objects 


A Trip  to  Objectville 


S Were  going  to  J 
Objectville!  Were 
* leaving  this  dusty  oT 
procedural  town  for  good 
I'll  send  you  a postcard. 


I was  told  there  would  be  objects.  In  chapter  1,  we  put  all  of  our  code  in  the 
main()  method.  That's  not  exactly  object-oriented.  In  fact,  that's  not  object-oriented  at  all.  Well, 
we  did  use  a few  objects,  like  the  String  arrays  for  the  Phrase-O-Matic,  but  we  didn't  actually 
develop  any  of  our  own  object  types.  So  now  we've  got  to  leave  that  procedural  world  behind, 
get  the  heck  out  of  main(),  and  start  making  some  objects  of  our  own.  We'll  look  at  what  makes 
object-oriented  (00)  development  in  Java  so  much  fun.  We'll  look  at  the  difference  between 
a class  and  an  object.  We'll  look  at  how  objects  can  give  you  a better  life  (at  least  the  program- 
ming part  of  your  life.  Not  much  we  can  do  about  your  fashion  sense).  Warning:  once  you  get 
to  Objectville,  you  might  never  go  back.  Send  us  a postcard. 
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once  upon  a time  in  Objectville 


Chair  Wars 

(or  How  Objects  Can  Change  Your  life) 

nee  upon  a time  in  a software  shop,  two 
programmers  were  given  the  same  spec  and  told  to 
“build  it”.  The  Really  Annoying  Project  Manager 
forced  the  two  coders  to  compete, 
by  promising  that  whoever  delivers 
first  gets  one  of  those  cool  Aeron™ 
chairs  all  the  Silicon  Valley  guys  have. 

Larry,  the  procedural  programmer,  and 
Brad,  the  OO  guy,  both  knew  this  would 
be  a piece  of  cake. 

Larry,  sitting  in  his  cube,  thought  to 
himself,  “What  are  the  things  this  program 
has  to  do ? What  procedures  do  we  need?”. 

And  he  answered  himself , “rotate  and 
playSound.”  So  off  he  went  to  build  the 
procedures.  After  all,  what  is  a program  if  not 
a pile  of  procedures? 

Brad,  meanwhile,  kicked  back  at  the  cafe 
and  thought  to  himself,  “What  are  the  things 
in  this  program...  who  are  the  key  players?”  He 
first  thought  of  The  Shapes.  Of  course,  there 
were  other  objects  he  thought  of  like  the  User,  the  Sound, 
and  the  Clicking  event.  But  he  already  had  a library  of  code 
for  those  pieces,  so  he  focused  on  building  Shapes.  Read 
on  to  see  how  Brad  and  Larry  built  their  programs,  and 
for  the  answer  to  your  burning  question,  “So,  who  got  the 
Aeron?” 


In  larry's  cube 

As  he  had  done  a gazillion  times  before,  Larry 
set  about  writing  his  Important  Procedures. 
He  wrote  rotate  and  playSound  in  no  time. 

rotate  (shapeNum)  { 

//  make  the  shape  rotate  360° 

} 

playSound  (shapeNum)  { 

//  use  shapeNum  to  lookup  which 
//  AIF  sound  to  play,  and  play  it 

} 


At  Prad' s laptop  at  the  cafe 

Brad  wrote  a class  for  each  of  the  three  shapes 


Square 

rotate()  { 

Circle 

II  code  to  rotate  a s 
} 

rotate()  { 

Triangle 

II  code  to  rotate  a c 

playSound))  { 

II  code  to  play  the  £ 

} 

rotate()  { 

II  code  to  rotate  a triangle 

II  for  a square 

playSoundQ  { 

II  code  to  play  the  I 

} 

II  for  a circle 

i 

playSoundQ  { 

//code  to  play  the  AIF  file 

II  for  a triangle 
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larry  thought  he'd  wailed  it.  He  could  almost  feel  the  rolled 
steel  of  the  Aerow  beweath  his... 


classes  and  objects 


Put  wait!  There's  beew  a spec  chawge. 

“OK,  technically  you  were  first,  Larry,”  said  the  Manager,  “but  we  have  to  add  just  one 
tiny  thing  to  the  program.  It’ll  be  no  problem  for  crack  programmers  like  you  two.” 


“If  I had  a dime  for  every  time  I’ve  heard  that  one ”,  thought  Larry,  knowing  that  spec- 
change-no-problem  was  a fantasy.  “And yet  Brad  looks  strangely  serene.  What’s  up  with 
that?”  Still,  Larry  held  tight  to  his  core  belief  that  the  OO  way,  while  cute,  was  just 
slow.  And  that  if  you  wanted  to  change  his  mind,  you’d  have  to  pry  it  from  his  cold, 


what  got  added  to  the  spec 


Pack  In  Larry's  cube 


At  Prad's  laptop  at  the  beach 


The  rotate  procedure  would  still  work;  the  code  used 
a lookup  table  to  match  a shapeNum  to  an  actual 
shape  graphic.  But  play  Sound  would  have  to  change. 
And  what  the  heck  is  a .hif  hie? 

playSound  ( shapeNum)  { 

//  if  the  shape  is  not  an  amoeba, 

//  use  shapeNum  to  lookup  which 
//  AIF  sound  to  play,  and  play  it 
//  else 

//  play  amoeba  .hif  sound 

} 

It  turned  out  not  to  be  such  a big  deal,  but  it  still 
made  him  queasy  to  touch  previously-tested  code.  Of 
all  people,  he  should  know  that  no  matter  what  the 
project  manager  says,  the  spec  always  changes. 


Brad  smiled,  sipped  his  margarita,  and  wrote  one 
new  class.  Sometimes  the  thing  he  loved  most 
about  OO  was  that  he  didn’t  have  to  touch  code 


he’d  already  tested  and  delivered.  “Flexibility, 
extensibility,...”  he  mused,  reflecting  on  the 


benefits  of  OO. 


Amoeba 

rotate()  { 

II  code  to  rotate  an  amoeba 

} 

playSound()  { 

II  code  to  play  the  new 
II  .hif  file  for  an  amoeba 
} 
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once  upon  a time  in  Objectville 


Larry  snuck  in  just  moments  ahead  of  Brad. 

(Hah!  So  much  for  that  foofy  OO  nonsense).  But  the  smirk  on  Larry’s  face  melted  when  the 
Really  Annoying  Project  Manager  said  (with  that  tone  of  disappointment),  “Oh,  no,  that’s  not 
how  the  amoeba  is  supposed  to  rotate...” 

Turns  out,  both  programmers  had  written  their  rotate  code  like  this: 

1)  determine  the  rectangle  that  surrounds  the  shape 

2)  calculate  the  center  of  that  rectangle,  and  rotate  the  shape  around  that  point. 

But  the  amoeba  shape  was  supposed  to  rotate  around  a point  on  one  end,  like  a clock  hand. 

“I’m  toast.”  thought  Larry,  visualizing  charred  Wonderbread™.  “Although,  hmmmm.  I could 
just  add  another  if/else  to  the  rotate  procedure,  and  then  just  hard-code  the  rotation  point 
code  for  the  amoeba.  That  probably  won’t  break  anything.”  But  the  little  voice  at  the  back  of 
his  head  said,  “Big  Mistake.  Do  you  honestly  think  the  spec  won’t  change  again?” 


m 


What  the  spec  conveniently 
forgot  to  mention 


Pack  in  Larry's  cube 

He  figured  he  better  add  rotation  point  arguments 
to  the  rotate  procedure.  A lot  opcode  was  affected. 
Testing,  recompiling,  the  whole  nine  yards  all  over 
again.  Things  that  used  to  work,  didn’t. 

rotate  (shapeNum,  xPt,  yPt)  { 

//  if  the  shape  is  not  an  amoeba, 

//  calculate  the  center  point 
//  based  on  a rectangle, 

//  then  rotate 
//  else 

//  use  the  xPt  and  yPt  as 
//  the  rotation  point  offset 
//  and  then  rotate 

} 


Amoeba 


At  Prad's  laptop  on  his  lawn 
chair  at  the  Telluride  Pluegrass  Festival 

Without  missing  a beat,  Brad  modified  the  rotate 
method,  but  only  in  the  Amoeba  class.  He  never 
touched  the  tested , working , 
compiled  code  for  the  other 
parts  of  the  program.  To 
give  the  Amoeba  a rota- 
tion point,  he  added  an 
attribute  that  all  Amoebas 
would  have.  He  modi- 
fied, tested,  and  delivered 
(wirelessly)  the  revised 
program  during  a single 
Bela  Fleck  set. 


int  xPoint 
int  yPoint 
rotate()  { 

II  code  to  rotate  an  amoeba 
II  using  amoeba’s  x and  y 
} 

playSound()  { 

II  code  to  play  the  new 
II  .hit  file  for  an  amoeba 
} 
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So,  Prad  the  00  guy  got  the  chair,  right? 

Not  so  fast.  Larry  found  a flaw  in  Brad’s  approach.  And, 
since  he  was  sure  that  if  he  got  the  chair  he’d  also  get  Lucy 
in  accounting,  he  had  to  turn  this  thing  around. 

LARRY:  You’ve  got  duplicated  code!  The  rotate 
procedure  is  in  all  four  Shape  things. 

BRAD:  It’s  a method,  not  a procedure.  And  they’re  classes, 
not  things. 

LARRY:  Whatever.  It’s  a stupid  design.  You  have  to 
maintain  four  different  rotate  “methods”.  How  can  that 
ever  be  good? 

BRAD:  Oh,  I guess  you  didn’t  see  the  final  design.  Let  me 
show  you  how  OO  inheritance  works,  Larry. 

What  Larry  wanted  2 
(figured  the  chair  would  impress  her) 


Square 

Circle 

Triangle 

Amoeba 

rotate  () 

rotate() 

rotate  0 

rotateQ 

playSoundQ 

playSoundQ 

playSoundQ 

playSoundQ 

o 

I looked  at  what  all  four 
classes  have  in  common. 


© 


They're  Shapes,  and  they  all  rotate  and 
playSound.  So  I abstracted  out  the 
common  features  and  put  them  into  a 
new  class  called  Shape. 


© 


You  can  read  this  as,  “Square  inherits  from  Shape”, 
“Circle  inherits  from  Shape”,  and  so  on.  I removed 
rotate()  and  playSound()  from  the  other  shapes,  so  now 
there’s  only  one  copy  to  maintain. 

The  Shape  class  is  called  the  superclass  of  the  other  four 
classes.  The  other  four  are  the  subclasses  of  Shape.  The 
subclasses  inherit  the  methods  of  the  superclass.  In  other 
words,  if  the  Shape  class  has  the  functionality,  then  the 
subclasses  automatically  get  that  same  functionality 


superclass 


z 


subclasses 


Then  I linked  the  other 
four  shape  classes  to 
the  new  Shape  class, 
in  a relationship  called 
inheritance. 


Square 

Circle 

Triangle 

Amoeba 
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once  upon  a time  in  Objectville 


What  about  the  Amoeba  rotateO? 


LARRY:  Wasn’t  that  the  whole  problem  here  — that  the  amoeba  shape 
had  a completely  different  rotate  and  playSound  procedure? 

BRAD:  Method. 


LARRY:  Whatever.  How  can  amoeba  do  something  different  if 
it  “inherits”  its  functionality  from  the  Shape  class? 

BRAD:  That’s  the  last  step.  The  Amoeba  class  overrides  the 
methods  of  the  Shape  class.  Then  at  runtime,  the  JVM  knows  exactly 
which  rotate()  method  to  run  when  someone  tells  the  Amoeba  to  rotate 


O 

I made  the  Amoeba  class  override 
the  rotateO  and  playSoundO 
methods  of  the  superclass  Shape. 

Overriding  just  means  that  a 
subclass  redefines  one  of  its 
inherited  methods  when  it  needs 
to  change  or  extend  the  behavior 
of  that  method. 

Overriding  methods 


LARRY:  How  do  you  “tell”  an  Amoeba  to 
do  something?  Don’t  you  have  to  call  the 
procedure,  sorry — method,  and  then  tell  it 
which  thing  to  rotate? 

BRAD:  That’s  the  really  cool  thing  about  OO. 
When  it’s  time  for,  say,  the  triangle  to  rotate, 
the  program  code  invokes  (calls)  the  rotate () 
method  on  the  triangle  object.  The  rest  of  the 
program  really  doesn’t  know  or  care  how  the 
triangle  does  it.  And  when  you  need  to  add 
something  new  to  the  program,  you  just  write 
a new  class  for  the  new  object  type,  so  the  new 
objects  will  have  their  own  behavior. 
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The  suspense  is  killing  me. 
Who  got  the  chair? 


Amy  from  the  second  floor. 

(unbeknownst  to  all,  the  Project 
Manager  had  given  the  spec  to 
three  programmers.) 


What  do  you  like  about  00? 

"It  helps  me  design  in  a more  natural  way.  Things 
have  a way  of  evolving." 

-Joy,  27,  software  architect 


"Not  messing  around  with  code  I've  already 
tested,  just  to  add  a new  feature." 

-Brad,  32,  programmer 

"I  like  that  the  data  and  the  methods  that  oper- 
ate on  that  data  are  together  in  one  class." 

-Josh,  22,  beer  drinker 

"Reusing  code  in  other  applications.  When  I write 
a new  class,  I can  make  it  flexible  enough  to  be 
used  in  something  new,  later." 

-Chris,  39,  project  manager 

"I  can't  believe  Chris  just  said  that.  He  hasn't 
written  a line  of  code  in  5 years." 

-Daryl,  44,  works  for  Chris 

"Besides  the  chair?" 

-Amy,  34,  programmer 


1* 


Time  to  pump  some  neurons. 

You  just  read  a story  bout  a procedural 
programmer  going  head-to-head  with  an  00 
programmer.  You  got  a quick  overview  of  some 
key  00  concepts  including  classes,  methods,  and 
attributes.  We'll  spend  the  rest  of  the  chapter 
looking  at  classes  and  objects  (we'll  return  to 
inheritance  and  overriding  in  later  chapters). 

Based  on  what  you've  seen  so  far  (and  what  you 
may  know  from  a previous  00  language  you've 
worked  with),  take  a moment  to  think  about 
these  questions: 

What  are  the  fundamental  things  you  need  to 
think  about  when  you  design  a Java  class?  What 
are  the  questions  you  need  to  ask  yourself? 

If  you  could  design  a checklist  to  use  when 
you're  designing  a class,  what  would  be  on  the 
checklist? 


ju eta  cognitive  tip 

If  you’re  stuck  on  an  exercise,  try  talking  about 
it  out  loud.  Speaking  (and  hearing)  activates 
a different  part  of  your  brain.  Although  it 
works  best  if  you  have  another  person  to 
discuss  it  with,  pets  work  too.  That’s  how 
our  dog  learned  polymorphism. 
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thinking  about  objects 


Whew  you  design  a class,  think  about  the  objects  that 
will  be  created  from  that  class  type.  Think  about: 

■ things  the  object  knows 

■ things  the  object  does 


ShoppingCart 

Button 

Alarm 

cartContents 

knows 

label 

color 

knows 

alarmTime 

alarmMode 

addToCart() 

removeFromCart() 

checkOut() 

does 

setColor() 

setLabel() 

dePress() 

unDepressQ 

does 

setAlarmTime() 

getAlarmTime() 

isAlarmSet() 

snoozeQ 

knows 

does 


Things 


Things 


an  object  knows  about  itself  are  called 

Song 

■ instance  variables 

instance 

variables 

title 

artist 

an  object  can  do  are  called 
■ methods 

(state) 

methods 

(behavior) 

setTitle() 

setArtist() 

playO 

knows 

does 


Things  an  object  knows  about  itself  are  called  instance 
variables.  They  represent  an  object’s  state  (the  data),  and 
can  have  unique  values  for  each  object  of  that  type. 

Think  of  instance  as  another  way  of  saying  object. 

Things  an  object  can  do  are  called  methods.  When  you 
design  a class,  you  think  about  the  data  an  object  will  need 
to  know  about  itself,  and  you  also  design  the  methods 
that  operate  on  that  data.  It’s  common  for  an  object  to 
have  methods  that  read  or  write  the  values  of  the  instance 
variables.  For  example,  Alarm  objects  have  an  instance 
variable  to  hold  the  alarmTime,  and  two  methods  for 
getting  and  setting  the  alarmTime. 

So  objects  have  instance  variables  and  methods,  but  those 
instance  variables  and  methods  are  designed  as  part  of  the 
class. 


; Sharpen  your  pencil 


Fill  in  what  a television  object 
might  need  to  know  and  do. 


instance 

variables 


methods 
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What’s  the  difference  between 
a class  and  an  object? 


A class  is  not  an  object. 

(but  it's  used  to  construct  them) 


A class  is  a blueprint  for  an  object.  It  tells  the 
virtual  machine  how  to  make  an  object  of  that 
particular  type.  Each  object  made  from  that 
class  can  have  its  own  values  for  the 
instance  variables  of  that  class.  For 
example,  you  might  use  the  Button 
class  to  make  dozens  of  different 
buttons,  and  each  button  might  have 
its  own  color,  size,  shape,  label,  and  so  on. 


dl  ass 


Look  at  it  this  wav. . . 


An  object  is  like  one  entry  in  your  address  book. 


/Q-S  \ 
Najne  VT" 

H P 


A 


m\. 


_L 


v 


Name  PoLlH  Morfisw. 
Phone  555^0 343 


One  analogy  for  objects  is  a packet  of  unused  Rolodex™  cards. 

Each  card  has  the  same  blank  fields  (the  instance  variables).  When 
you  fill  out  a card  you  are  creating  an  instance  (object),  and  the 
entries  you  make  on  that  card  represent  its  state. 

The  methods  of  the  class  are  the  things  you  do  to  a particular  card; 
getName( ),  changeName( ),  setName( ) could  all  be  methods  for 
class  Rolodex. 

So,  each  card  can  do  the  same  things  (getName( ),  changeName( ), 
etc.),  but  each  card  knows  things  unique  to  that  particular  card. 
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making  objects 


Making  your  first  object 


So  what  does  it  take  to  create  and  use  an  object?  You  need  two  classes.  One 
class  for  the  type  of  object  you  want  to  use  (Dog,  AlarmClock,  Television, 
etc.)  and  another  class  to  testyowc  new  class.  The  tester  class  is  where  you  put 
the  main  method,  and  in  that  main()  method  you  create  and  access  objects 
of  your  new  class  type.  The  tester  class  has  only  one  job:  to  try  out  the  meth- 
ods and  variables  of  your  new  object  class  type. 

From  this  point  forward  in  the  book,  you’ll  see  two  classes  in  many  of 
our  examples.  One  will  be  the  real  class  - the  class  whose  objects  we 
really  want  to  use,  and  the  other  class  will  be  the  tester  class,  which  we 
call  <whateverYourClassNameIs>  TestDrive.  For  example,  if  we  make  a 
Bungee  class,  we’ll  need  a BungeeTestDrive  class  as  well.  Only  the 
<someClassName>TestDrive  class  will  have  a main()  method,  and  its  sole 
purpose  is  to  create  objects  of  your  new  type  (the  not-the-tester  class),  and 
then  use  the  dot  operator  (.)  to  access  the  methods  and  variables  of  the  new 
objects.  This  will  all  be  made  stunningly  clear  by  the  following  examples. 

Write  your  class 

class  Dog  { 


int  size; 
String  breed; 
String  name; 

void  bark ( ) { 

System. out . 


"shut' 


v^u 


cs 


a ^c-thod 


DOG 


size 

breed 

name 


bark() 


Lntln ( "Ruff ! Ruff ! " ) ; 


The  Dot  Operator  (.) 

The  dot  operator  (.)  gives 
you  access  to  an  object's 
state  and  behavior  (instance 
variables  and  methods). 

//  make  a new  object 

Dog  d = new  Dog(); 

//  tell  it  to  bark  by  using  the 
//  dot  operator  on  the 
//  variable  d to  call  bark() 

d.bark(); 

//  set  its  size  using  the 
//  dot  operator 

d.size  = 40; 


} 

} 


^ Write  a tester  (TestDrive)  class 


y i t 1. 


class  DogTestDrive  { 

public  static  void  main  ( String [] 
//  Dog  test  code  goes  here 


args)  { 


,A> 


} 


} 


©In  your  tester,  make  an  object  and  access 
the  object's  variables  and  methods 


class  DogTestDrive  { 

public  static  void  main  (String []  args)  { 

Dog  d = new  Dog()  ; - "n3^e  3 £>0g  objeci 

d . size  = 40 ; ^ we  the  M Q 

^ 4A  bark  ( } 'X  ihe  of  he  t)0* 

^ U is"  * 5 


If  you  already  have  some  00  savvy, 
you'll  know  we're  not  using  encapsulation. 
We'll  get  there  in  chapter  4. 
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class  Movie  { 

String  title; 

String  genre; 
int  rating; 

void  playlt()  { 

System. out .pr in tin ("Playing  the  movie"); 

} 

} 

public  class  MovieTestDrive  { 

public  static  void  main (String []  args)  { 

Movie  one  = new  Movie ( ) ; 
one. title  = "Gone  with  the  Stock"; 
one . genre  = "Tragic" ; 
one . rating  = -2 ; 

Movie  two  = new  Movie ( ) ; 

two. title  = "Lost  in  Cubicle  Space"; 

two. genre  = "Comedy"; 

two . rating  = 5 ; 

two.playIt() ; 

Movie  three  = new  Movie ( ) ; 
three . title  = "Byte  Club" ; 

three. genre  = "Tragic  but  ultimately  uplifting"; 
three. rating  = 127; 

} 


MOVIE 

title 

genre 

rating 

playlt() 


object  1 


r 


title 


The  MovieTestDrive  class  creates  objects  (instances)  of 
the  Movie  class  and  uses  the  dot  operator  (.)  to  set  the 
instance  variables  to  a specific  value. The  MovieTestDrive 
class  also  invokes  (calls)  a method  on  one  of  the  objects. 
Fill  in  the  chart  to  the  right  with  the  values  the  three 
objects  have  at  the  end  of  main(). 


object  2 


genre 

rating 


object  3 
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get  the  heck  out  of  main 


Quick!  fret  out  of  main! 

As  long  as  you’re  in  main(),  you’re  not  really  in  Objectville.  It’s  fine  for  a test 
program  to  run  within  the  main  method,  but  in  a true  OO  application,  you 
need  objects  talking  to  other  objects,  as  opposed  to  a static  main()  method 
creating  and  testing  objects. 


The  two  uses  of  mam: 

■ to  test  your  real  class 

■ to  launch/start  your  Java  application 


A real  Java  application  is  nothing  but  objects  talking  to  other  objects.  In  this 
case,  talking  means  objects  calling  methods  on  one  another.  On  the  previous 
page,  and  in  chapter  4 , we  look  at  using  a main()  method  from  a separate 
TestDrive  class  to  create  and  test  the  methods  and  variables  of  another  class.  In 
chapter  6 we  look  at  using  a class  with  a main()  method  to  start  the  ball  rolling 
on  a rm/Java  application  (by  making  objects  and  then  turning  those  objects 
loose  to  interact  with  other  objects,  etc.) 

As  a ‘sneak  preview’,  though,  of  how  a real  Java  application  might  behave, 
here’s  a little  example.  Because  we’re  still  at  the  earliest  stages  of  learning  Java, 
we’re  working  with  a small  toolkit,  so  you’ll  find  this  program  a little  clunky 
and  inefficient.  You  might  want  to  think  about  what  you  could  do  to  improve 
it,  and  in  later  chapters  that’s  exactly  what  we’ll  do.  Don’t  worry  if  some  of  the 
code  is  confusing;  the  key  point  of  this  example  is  that  objects  talk  to  objects. 


GameLauncher 


The  Guessing  (tame 

Summary: 

The  guessing  game  involves  a 'game'  object  and  three  'player'  objects. The  game  gen- 
erates a random  number  between  0 and  9,  and  the  three  player  objects  try  to  guess 
it.  (We  didn't  say  it  was  a really  exciting  game.) 

Classes: 

GuessGame . class  Player . class  GameLauncher . class 

The  Logic: 

1)  The  GameLauncher  class  is  where  the  application  starts;  it  has  the  main()  method. 

2)  In  the  main  ()  method,  a GuessGame  object  is  created,  and  its  startGameO  method 
is  called. 

3)  The  GuessGame  object's  startGameO  method  is  where  the  entire  game  plays  out. 

It  creates  three  players,  then  "thinks"  of  a random  number  (the  target  for  the  players 
to  guess).  It  then  asks  each  player  to  guess,  checks  the  result,  and  either  prints  out 
information  about  the  winning  player(s)  or  asks  them  to  guess  again. 


GuessGame 


Pi 

P2 

P3 


rubles 
^otrihe  II 


Yee 


startGameO 
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public  class  GuessGame 
Player  pi; 

Player  p2; 

Player  p3; 


e 


.tSfe 

obj«“  U ik’  ikr"  P V 


public  void  startGameO 
pi  = new  Player (); 
p2  = new  Player  (); 
p3  = new  Player  (); 


™ern  tie  tiric  Playev. 

iKsiaue  variables  ' 


int  guesspl  = 0; 
int  guessp2  = 0; 
int  guessp3  = 0; 


y . declare  three  variables  to  hold  the 

ST  three  guesses  the  Players  make 


boolean  plisRight 
boolean  p2isRight 
boolean  p3isRight 


false;  < f'f*™  th,r«  tables  to  hold  a true  or 

false;  +alse  based  oh  the  player's  answer 


int  targetNumber  = (int)  (Math . random ( ) * 10); 

System. out .println ("I'm  thinking  of  a number  between  0 and  9... 


while  (true)  { 

System. out .println ("Number  to  guess  is  " + targetNumber); 


n>ake  a 'target'  number  that  the 
players  have  to  guess 


p2 ! guess  ( ) ; £ " PlaY«-'s  9>*ess0  method 

p3 . guess  ( ) ; 


guesspl  = pi. number; 

System. out .println ("Player  one  guessed 
guessp2  = p2. number; 

System. out .println ("Player  two  guessed 


guessp3  = p3. number; 

System. out .println ("Player  three  guessed 


+ guessp3) ; 


get  each  player's  guess  (the  result  of  their 
guesst;  method  running)  by  accessing  the 
number  variable  or  each  player 


if  (guesspl  ==  targetNumber) 
plisRight  = true; 

} 

if  (guessp2  ==  targetNumber) 
p2isRight  = true; 

} 

if  (guessp3  ==  targetNumber) 
p3isRight  = true; 

} 


eheck  each  players  guess  to  see  if  it  matches 
the  target  number.  |f  a player  is  right, 
then  set  that  player's  variable  to  be  true 
(remember,  we  set  it  -false  by  default) 


if  (plisRight  | i p2isRight  | | p3isRight)  { player  two  OR  player  three  is  riaht- 

(the  ||  operator  means  OR)  3 

System. out .println ("We  have  a winner!") ; 

System. out .println ("Player  one  got  it  right?  " + plisRight); 

System. out .println ("Player  two  got  it  right?  " + p2isRight); 

System. out .println ("Player  three  got  it  right?  " + p3isRight); 

System. out .println ("Game  is  over.") ; 

break;  //  game  over,  so  break  out  of  the  loop 


} else  { 

//  we  must  keep  going  because  nobody  got  it  right! 
System. out .println ("Players  will  have  to  try  again."); 
} //  end  if/else 
} //  end  loop 
} / / end  method 
} //  end  class 
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Guessing  Game 


Running  the  Guessing  frame 

public  class  Player  { 

int  number  =0;  //  where  the  guess  goes 


public  void  guess ()  { 

number  = (int)  (Math . random ( ) * 10); 
System . out . println ( "I ' m guessing  " 

+ number) ; 


public  class  GameLauncher  { 

public  static  void  main  (String []  args) 
GuessGame  game  = new  GuessGame () ; 
game . startGame ( ) ; 


Java  takes  out  the 
Garbage 

Each  time  an  object  is  created 
in  Java,  it  goes  into  an  area  of 
memory  known  as  The  Heap. 

All  objects — no  matter  when,  where, 
or  how  they're  created  - live  on  the 
heap.  But  it's  not  just  any  old  memory 
heap;the  Java  heap  is  actually  called  the 
Garbage-Collectible  Heap.  When  you 
create  an  object,  Java  allocates  memory 
space  on  the  heap  according  to  how 
much  that  particular  object  needs.  An 
object  with,  say,  1 5 instance  variables, 
will  probably  need  more  space  than  an 
object  with  only  two  instance  variables. 
But  what  happens  when  you  need  to 
reclaim  that  space?  How  do  you  get  an 
object  out  of  the  heap  when  you're  done 
with  it?  Java  manages  that  memory 
for  you!  When  the  JVM  can  'see' that  an 
object  can  never  be  used  again,  that 
object  becomes  eligible  for  garbage 
collection.  And  if  you're  running  low  on 
memory,  the  Garbage  Collector  will  run, 
throw  out  the  unreachable  objects,  and 
free  up  the  space,  so  that  the  space  can 
be  reused.  In  later  chapters  you'll  learn 
more  about  how  this  works. 


Output  (it  will  be  different  each  time  you  run  it) 


%java  GameLauncher 

I'm  thinking  of  a number  between  0 and  9. . . 

Number  to  guess  is  7 

I'm  guessing  1 

I'm  guessing  9 

I'm  guessing  9 

Player  one  guessed  1 

Player  two  guessed  9 

Player  three  guessed  9 

Players  will  have  to  try  again. 

Number  to  guess  is  7 

I'm  guessing  3 

I'm  guessing  0 

I'm  guessing  9 

Player  one  guessed  3 

Player  two  guessed  0 

Player  three  guessed  9 

Players  will  have  to  try  again. 

Number  to  guess  is  7 
I'm  guessing  7 
I'm  guessing  5 
I'm  guessing  0 
Player  one  guessed  7 
Player  two  guessed  5 
Player  three  guessed  0 
We  have  a winner! 

Player  one  got  it  right?  true 
Player  two  got  it  right?  false 
Player  three  got  it  right?  false 
Game  is  over. 
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r^tliereiare  no 

Dumb  Questions 

Q?  What  if  I need  global 
variables  and  methods?  How 
do  I do  that  if  everything  has  to 
go  in  a class? 


A: 


L-  There  isn't  a concept  of 
'global'variables  and  methods  in 
a Java  00  program.  In  practical 
use,  however,  there  are  times 
when  you  want  a method  (or 
a constant)  to  be  available 
to  any  code  running  in  any 
part  of  your  program. Think 
of  the  random  ( ) method  in 
the  Phrase-O-Matic  app;  it's  a 
method  that  should  be  callable 
from  anywhere.  Or  what  about 
a constant  like  p/7  You'll  learn 
in  chapter  10  that  marking 
a method  as  public  and 
static  makes  it  behave  much 
like  a 'global'.  Any  code,  in  any 
class  of  your  application,  can 
access  a public  static  method. 
And  if  you  mark  a variable  as 
public,  static, and  final 
- you  have  essentially  made  a 
globally-available  constant. 


Q?  Then  how  is  this  object- 
oriented  if  you  can  still  make 
global  functions  and  global 
data? 


A: 


First  of  all,  everything 
in  Java  goes  in  a class.  So  the 
constant  for  pi  and  the  method 
for  random  ( ) , although  both 
public  and  static,  are  defined 
within  the  Math  class.  And  you 
must  keep  in  mind  that  these 
static  (global-like)  things  are  the 
exception  rather  than  the  rule 
in  Java. They  represent  a very 
special  case,  where  you  don't 
have  multiple  instances/objects. 


% What  is  a Java  program? 
What  do  you  actually  deliverl 


A: 


A Java  program  is  a pile 
of  classes  (or  at  least  one  class). 

In  a Java  application,  one  of 
the  classes  must  have  a main 
method,  used  to  start-up  the 
program.  So  as  a programmer, 
you  write  one  or  more  classes. 
And  those  classes  are  what  you 
deliver.  If  the  end-user  doesn't 
have  a JVM,  then  you'll  also 
need  to  include  that  with 
your  application's  classes, 
so  that  they  can  run  your 
program. There  are  a number 
of  installer  programs  that 
let  you  bundle  your  classes 
with  a variety  of  JVM's  (say,  for 
different  platforms),  and  put  it  all 
on  a CD-ROM. Then  the  end-user 
can  install  the  correct  version  of 
the  JVM  (assuming  they  don't 
already  have  it  on  their  machine.) 


% What  if  I have  a hundred 
classes?  Or  a thousand?  Isn't 
that  a big  pain  to  deliver 
all  those  individual  files? 

Can  I bundle  them  into  one 
Application  Thing ? 


A***  * StekftS  ^ 

nofafyC) 

^ class  is  like  a recipe 
Objects  are  like 

f (homipCWfMw  co°kies. 


A: 


L-  Yes,  it  would  be  a big 
pain  to  deliver  a huge  bunch  of 
individual  files  to  your  end-users, 
but  you  won't  have  to.  You  can 
put  all  of  your  application  files 
into  a Java  Archive  - a .jar  file  - 
that's  based  on  the  pkzip  format. 
In  the  jar  file,  you  can  include 
a simple  text  file  formatted  as 
something  called  a manifest,  that 
defines  which  class  in  that  jar 
holds  the  main()  method  that 
should  run. 


BULLET  POINTS 

Object-oriented  programming  lets  you  extend 
a program  without  having  to  touch  previously- 
tested,  working  code. 

All  Java  code  is  defined  in  a class. 

A class  describes  how  to  make  an  object  of 
that  class  type.  A class  is  like  a blueprint. 
An  object  can  take  care  of  itself;  you  don’t 
have  to  know  or  care  how  the  object  does  it. 
An  object  knows  things  and  does  things. 
Things  an  object  knows  about  itself  are  called 
instance  variables.  They  represent  the  state 
of  an  object. 

Things  an  object  does  are  called  methods. 
They  represent  the  behavior  of  an  object. 
When  you  create  a class,  you  may  also  want 
to  create  a separate  test  class  which  you’ll 
use  to  create  objects  of  your  new  class  type. 
A class  can  inherit  instance  variables  and 
methods  from  a more  abstract  superclass. 

At  runtime,  a Java  program  is  nothing  more 
than  objects  ‘talking’  to  other  objects. 
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BE  the  compiler 

Each  of  the  Java  files  on  this  page 
represents  a complete  source  file. 
Your  job  is  to  play  compiler  and 

determine  whether  each  of 
these  files  will  compile. 
If  they  won’t  compile, 
how  would  you  fix  them, 
and  if  they  do  compile, 
what  would  he  their  output? 


A 

class  TapeDeck  { 

boolean  canRecord  = false; 
void  playTape ( ) { 

System. out .println ("tape  playing") ; 

} 

void  recordTape()  { 

System. out .println ("tape  recording") ; 

} 

} 

class  TapeDeckTestDrive  { 

public  static  void  main (String  []  args)  { 

t. canRecord  = true; 
t .playTape ( ) ; 

if  (t. canRecord  ==  true)  { 
t . recordTape ( ) ; 

} 

} 

} 


B 

class  DVDPlayer  { 

boolean  canRecord  = false; 
void  recordDVD()  { 

System. out .println ("DVD  recording") ; 

} 

} 

class  DVDPlayerTestDrive  { 

public  static  void  main (String  []  args)  { 

DVDPlayer  d = new  DVDPlayer (); 
d. canRecord  = true; 
d.playDVD ( ) ; 

if  (d. canRecord  ==  true)  { 
d. recordDVD ( ) ; 

} 

} 

} 
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Code  Magnets 

A Java  program  is  all  scrambled  up  on 
the  fridge.  Can  you  reconstruct  the 
code  snippets  to  make  a working  Java 
program  that  produces  the  output  listed 
below?  Some  of  the  curly  braces  fell  on 
the  floor  and  they  were  too  small  to  pick 
up,  so  feel  free  to  add  as  many  of  those 
as  you  need. 


DrumKit  d = new  DrumKitO; 


^il^^di^/vindov^ei^^anc^ 


% java  DrumKitTes tDrive 
bang  bang  ba-bang 
ding  ding  da-ding 


public  static  void  main (String  []  args)  { 
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puzzle:  Pool  Puzzle 


P<m>]  puzzje 


Your  job  is  to  take  code  snippets  from 
the  pool  and  place  them  into  the 
blank  lines  in  the  code.  You  may 
use  the  same  snippet  more  than 
once,  and  you  won't  need  to  use 
all  the  snippets.  Your  goal  is  to 
make  classes  that  will  compile  and 
run  and  produce  the  output  listed. 


Output 

^Tn^^di^/vindovi^Hei^mpIod^ 


%java  EchoTestDrive 
helloooo. . . 
helloooo. . . 
helloooo. . . 
helloooo. . . 

10 


Bonus  Question  ! 

If  the  last  line  of  output  was 
24  instead  of  10  how  would 
you  complete  the  puzzle  ? 


public  class  EchoTestDrive  { 

public  static  void  main (String  []  args)  { 
Echo  el  = new  Echo(); 


int  x = 0; 

while  ( ) { 

el .hello ( ) ; 


if  ( ) { 

e2. count  = e2. count  + 1; 

} 

if  ( ) { 

e2. count  = e2. count  + el. count; 

} 

x = x + 1 ; 

} 

System. out .print In (e2 . count) ; 

} 

} 


class  { 

int  - 0 ; 

void  { 

System. out .println ("helloooo . . . 

} 

} 

") ; 

Note:  Each  snippet 
from  the  pool  can  be 
used  more  than  once! 


A x 

x < 4 

///  y 

x < 5 

Echo 

yy  e2 

x > 0 

Tester 

count 

x > 1 

echo( ) 

e2  = e1; 

el  = el  + 1; 

count( ) 

Echo  e2; 

el  = count  + 1; 

el. count  = count  + 1; 

el  .count  = el  .count  + 1 ; 

helloO 

Echo  e2  = el; 

Echo  e2  = new  Echo( ); 
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A bunch  of  Java  components,  in  full  costume,  are  playing  a party 
game, "Who  am  I?"  They  give  you  a clue,  and  you  try  to  guess  who 
they  are,  based  on  what  they  say.  Assume  they  always  tell  the  truth 
about  themselves.  If  they  happen  to  say  something  that  could  be  true 
for  more  than  one  of  them,  choose  all  for  whom  that  sentence  can 
apply.  Fill  in  the  blanks  next  to  the  sentence  with  the  names  of  one  or 
more  attendees. The  first  one's  on  us. 


Tonight's  attendees: 

Class  Method  Object 


Instance  variable 


I am  compiled  from  a .java  file. 

My  instance  variable  values  can 
be  different  from  my  buddy’s 
values. 


dldss 


I behave  like  a template. 

I like  to  do  stuff. 

I can  have  many  methods. 

I represent  ‘state’. 

I have  behaviors. 

I am  located  in  objects. 

I live  on  the  heap. 

I am  used  to  create  object  instances. 
My  state  can  change. 

I declare  methods. 

I can  change  at  runtime. 
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Exercise  Solutions 


Code  Magnets: 

class  DrumKit  { 

boolean  topHat  = true; 
boolean  snare  = true; 

void  playTopHat()  { 

System . out . print In ( "ding  ding  da-ding"); 

} 

void  playSnare()  { 

System . out . print in ( "bang  bang  ba-bang") ; 

} 

} 

class  DrumKitTestDrive  { 

public  static  void  main (String  []  args)  { 

DrumKit  d = new  DrumKit (); 
d . playSnare ( ) ; 
d. snare  = false; 
d.playTopHat  () ; 

if  (d. snare  ==  true)  { 
d . playSnare ( ) ; 

} 

} 

} 

^Fil^^di^/Vindovl^el^^anc^^- 


% java  DrumKitTestDrive 
bang  bang  ba-bang 
ding  ding  da-ding 


Be  the  Compiler: 

class  TapeDeck  { 

boolean  canRecord  = false; 
void  playTape ( ) { 

System. out .println ("tape  playing") ; 

A > 

void  recordTape ( ) { 

System. out .println ("tape  recording") ; 

} 

} 

class  TapeDeckTestDrive  { 

public  static  void  main (String  []  args)  { 

TapeDeck  t = new  TapeDeck( ); 

t. canRecord  = true; 
t .playTape ( ) ; 

if  (t. canRecord  ==  true)  { 
t . recordTape ( ) ; 

} 

} 

} 


class  DVDPlayer  { 

boolean  canRecord  = false; 
void  recordDVD()  { 

System. out .println ("DVD  recording") ; 

} 

void  playDVD  ( ) { 

System . out . printlnfDVD  playing"): 

} 


class  DVDPlayerTestDrive  { 

public  static  void  main (String  []  args)  { 
DVDPlayer  d = new  DVDPlayer (); 
d. canRecord  = true; 
d. playDVD ( ) ; 

if  (d. canRecord  ==  true)  { 


d. recordDVD ( ) ; 


We've  got  the  template,  now  we  have 
to  make  an  object ! 


46  chapter  2 


The  line:  d.playDVD( );  wouldn't 
compile  without  a method  ! 


classes  and  objects 


puzzle  Solutions 


Pool  Puzzle 

public  class  EchoTestDrive  { 

public  static  void  main (String  []  args)  { 
Echo  el  = new  Echo(); 

Echo  e2  = new  Echo( );  //  the  correct  answer 
- or  - 

Echo  e2  = el;  //  is  the  bonus  answer\ 

int  x = 0; 
while  ( X < 4 ) { 
el  .hello  ()  ; 

el.count  = el. count  + 1; 

if  ( X ==  3 ) { 

e2 . count  = e2 . count  + 1; 

} 

if  ( X > 0 ) { 

e2 . count  = e2 . count  + el.count; 

} 

x = x + 1; 

} 

System. out .print in (e2 . count) ; 

} 

} 


class  Echo  { 
int  COUnt  = 0; 
void  hello()  { 


System. out .println ("helloooo ...  ") ; 

} 

} 


\Vli©  am  I? 


I am  compiled  from  a .java  file. 

My  instance  variable  values  can  be 
different  from  my  buddy’s  values. 

I behave  like  a template. 

I like  to  do  stuff. 

I can  have  many  methods. 

I represent  ‘state’. 

I have  behaviors. 

I am  located  in  objects. 

I live  on  the  heap. 

I am  used  to  create  object 
instances. 

My  state  can  change. 

I declare  methods. 

I can  change  at  runtime. 


dlass 

objedt 

dlass 

objedt,  method 
dlass,  objedt 
instande  variable 
objedt,  dlass 

method,  instate  variable 
objedt 

dlass 

objedt,  instate  variable 
dlass 

objedt,  instate  variable 


Note:  both  classes  and  objects  are  said  to  have  state  and  behavior. 
They're  defined  in  the  class,  but  the  object  is  also  said  to  'have' 
them.  Right  now,  we  don't  care  where  they  technically  live. 


File  Edit  Window  Help  Assimilate 


% java  EchoTestDrive 
helloooo . . . 
helloooo . . . 
helloooo . . . 
helloooo . . . 

10 
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Know  Your  Variables 


Variables  come  in  two  flavors:  primitive  and  reference.  So  far  you've 

used  variables  in  two  places — as  object  state  (instance  variables),  and  as  local  variables 
(variables  declared  within  a method).  Later,  we'll  use  variables  as  arguments  (values  sent  to  a 
method  by  the  calling  code), and  as  return  types  (values  sent  back  to  the  caller  of  the  method). 
You've  seen  variables  declared  as  simple  primitive  integer  values  (type  int).  You've  seen 
variables  declared  as  something  more  complex  like  a String  or  an  array.  But  there’s  gotta  be 
more  to  life  than  integers,  Strings,  and  arrays.  What  if  you  have  a PetOwner  object  with  a Dog 
instance  variable?  Or  a Car  with  an  Engine?  In  this  chapter  we'll  unwrap  the  mysteries  of  Java 
types  and  look  at  what  you  can  declare  as  a variable,  what  you  can  put  in  a variable,  and  what  you 
can  do  with  a variable.  And  we'll  finally  see  what  life  Is  truly  like  on  the  garbage-collectible  heap. 


this  is  a new  chapter  49 


declaring  a variable 
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declaring  a variable 

Java  cares  about  type.  It  won't  let  you  do 
something  bizarre  and  dangerous  like  stuff  a 
Giraffe  reference  into  a Rabbit  variable — what 
happens  when  someone  tries  to  ask  the  so-called 
Rabbit  to  hop  ( ) ? And  it  won’t  let  you  put  a 
floating  point  number  into  an  integer  variable, 
unless  you  acknowledge  to  the  compiler  that  you 
know  you  might  lose  precision  (like,  everything 
after  the  decimal  point). 

The  compiler  can  spot  most  problems: 

Rabbit  hopper  = new  Giraffe  ()  ; 

Don’t  expect  that  to  compile.  Thankfully . 

For  all  this  type-safety  to  work,  you  must  declare 
the  type  of  your  variable.  Is  it  an  integer?  a Dog? 
A single  character?  Variables  come  in  two  flavors: 
primitive  and  object  reference.  Primitives  hold 
fundamental  values  (think:  simple  bit  patterns) 
including  integers,  booleans,  and  floating  point 
numbers.  Object  references  hold,  well,  references 
to  objects  (gee,  didn't  that  clear  it  up.) 

Well  look  at  primitives  first  and  then  move 
on  to  what  an  object  reference  really  means. 

But  regardless  of  the  type,  you  must  follow  two 
declaration  rules; 

variables  must  have  a type 

Besides  a type,  a variable  needs  a name,  so  that 
you  can  use  that  name  in  code. 

variables  must  have  a name 

int  count ; 

■type  hd»c 


Note:  When  you  see  a statement  like:  "an  object 
of  type  X”,  think  of  type  and  class  as  synonyms. 
(We'll  refine  that  a little  more  in  later  chapters.) 
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Td  like  a double  mocha,  ho,  make  It  an  int." 

When  you  think  of  Java  variables,  think  of  cups.  Coffee  cups,  tea  cups,  giant 
0^3$  that  hold  lots  and  lots  of  beer,  those  big  cups  the  popcorn  comes  in  at 
movies,  cups  with  curvy,  sexy  handles,  and  cups  with  metallic  trim  that 
mm  learned  can  never,  ever  go  in  the  microwave. 

A variable  is  just  a cup.  A container.  It  holds  something. 

fc  has  a size,  and  a type.  In  this  chapter,  we’re  going  to  look  first  at  the 
'nriables  (cups)  that  hold  primitives,  then  a Jitde  later  we’ll  look  at  cups 
feat  hold  references  to  objects.  Stay  with  us  here  on  the  whole  cup  analogy — as 
mm pie  as  it  is  right  now,  it’ll  give  us  a common  way  to  look  at  things  when 
discussion  gets  more  complex.  And  that’ll  happen  soon. 

ftimitives  are  like  the  cups  they  have  at  the  coffeehouse.  If  you’ve  been  to  a 
farbucks,  you  know  what  we're  talking  about  here.  They  come  in  different 
nes.  and  each  has  a name  like  'short’,  'tali',  and,  Td  like  a 
'V ande’  mocha  half-caff  with  extra  whipped  cream”. 

might  see  the  cups  displayed  on  the  counter, 
tou  can  order  appropriately: 


small  short 


grande 


And  in  Java,  primitives  come  in  different  sizes,  and  those  sizes 
have  names.  When  you  declare  a variable  in  Java, 

Oyou  must  declare  it  with  a specific  type.  The 
I four  containers  here  are  for  the  four 

' integer  primitives  in  Java. 

long  int  short  byte 

Earh  cup  holds  a value,  so  for  Java  primitives,  rather  than  saying,  Td  like  a 
mM  french  roast”,  you  say  to  the  compiler,  Td  like  an  int  variable  with  the 
sanber  90  please.”  Except  for  one  tiny  difference...  in  Java  you  also  have  to 
your  cup  a name.  So  it’s  actually,  Td  like  an  int  please,  with  the  value 
at  2486,  and  name  the  variable  height”  Each  primitive  variable  has  a fixed 
nber  of  bits  (cup  size) . The  sizes  for  the  six  numeric  primitives  in  Java 
; shown  below: 


byte  short  int 

8 16  32 


float  double 

32  64 


Primitive  Types 

Type  Bit  Depth  Value  Range 

boolean  and  char 

boolean  uvM-jpedfic)  true  ot  false 
char  16  bits  0 to  65535 

numeric  (all  are  signed) 

Integer 


byte 

8 bits 

-128  to  127 

short 

16  bits 

-32768  to 
32767 

int 

32  bits 

-2147483648 

to  2147483647 

long 

64  bits 

-huge  to  huge 

floating  point 

float 

32  bits 

varies 

double 

64  bits 

varies 

Primitive  declarations 
with  assignments; 

int  x; 
x = 234; 
byte  b = 89; 
boolean  isFun  = true; 
double  d = 3456.98; 
char  c = lfl; 


int  z = x; 


boolean  IsPunkRock; 
isPunkRock  = false; 
boolean  powerOn; 
powerOn  = IsFun; 
long  big  = 34S6789; 
float  f = 32.5f; 


. 6«fcla  && 

- bemuse  , . 


you  are  here  ► 51 


primitive  assignment 


You  really  don't  want  to  spill  that... 

Be  sure  the  value  can  fit  into  the  variable* 

You  can't  put  a large  value  into  a 
small  cup. 

Well,  OK,  you  can,  but  you'll 
lose  some.  You'll  get,  as  we  say, 
spillage.  The  compiler  tries  to 
help  prevent  this  if  it  can  tell 
from  your  code  that  something's 
not  going  to  fit  in  the  container 
(variable/cup)  you're  using. 

For  example,  you  can't  pour  an 
int-full  of  stuff  into  a byte-sized 
container,  as  follows: 

int  x = 24; 

byte  b = x; 

//won' c work ! ! 


Why  doesn't  this  work,  you  ask?  After  all,  the  value  of  x is  24,  and  24  is  definitely 
small  enough  to  fit  into  a byte.  You  know  that,  and  toe  know  that,  but  all  the 
compiler  cares  about  is  that  you're  trying  to  put  a big  thing  into  a small  thing, 
and  there's  the  possibility  of  spilling*  Don't  expect  the  compiler  to  know  what  the 
value  of  x is,  even  if  you  happen  to  be  able  to  see  it  literally  in  your  code. 

You  can  assign  a value  to  a variable  in  one  of  several  ways  including: 

■ type  a literal  value  after  the  equals  sign  (x=/2,  isGood  = true,  etc.) 

■ assign  the  value  of  one  variable  to  another  (x  = y) 

■ use  an  expression  combining  the  two  (x  = y +43) 

In  the  examples  below,  the  literal  values  are  in  bold  italics: 

int  size  = 32 ; declare  an  int  named  s/ze,  assign  it  the  value  32 

char  initial  = ' j' ; declare  a char  named  initial,  assign  it  the  value  ‘f 

double  d = 456.709;  declare  a double  named  d,  assign  it  the  value  456.709 

boolean  isCrazy;  declare  a boolean  named  IsCrazy  (no  assignment) 

isCrazy  = true;  assign  the  value  true  to  the  previously-declared  isCrazy 

int  y = x + 456;  declare  an  int  named  y,  assign  it  the  value  that  is  the  sum 

of  whatever  x is  now  plus  456 


arpen  your  pencil 


The  compiler  won't  let  you  put 
a value  from  a large  cup  into 
a small  one.  But  what  about 
the  other  way— pouring  a 
small  cup  into  a big  one?  No 
problem . 

Based  on  what  you  know 
about  the  size  and  type  of  the 
primitive  variables,  see  if  you 
can  figure  out  which  of  these 
are  legal  and  which  aren't. 

We  haven't  covered  all  the 
rules  yet,  so  on  some  of  these 
you'll  have  to  use  your  best 
judgment.  Tip: The  compiler 
always  errs  on  the  side  of 
safety. 


From  the  following  list,  Circle 
the  statements  that  would  be 
legal  if  these  lines  were  in  a 
single  method: 

1 . int  x = 34.5; 

2.  boolean  boo  = x; 


3.  int  g = 17; 

4 . int  y = g ; 
5*  y = y + 10; 


6.  short  s; 


7.  a = y; 

8.  byte  b « 3; 

9 . byte  v = b ; 


10.  short  n = 12; 


11.  v = n; 


12 . byte  k = 128 ; 
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Nek  away  from  that  keyword! 

You  know  you  need  a name  and  a type  for  your  variables. 

You  already  know  the  primitive  types. 

Brt  what  can  you  use  as  names?  The  rules  are  simple.  You 
ran  name  a class,  method,  or  variable  according  to  the 
showing  rules  (the  real  rules  axe  slightly  more  flexible, 
but  these  will  keep  you  safe) : I 

■ ft  must  start  with  a latter,  underscore  (J,  or 
dollar  sign  ($).  You  can’t  start  a name  with  a 
number. 

■ After  the  first  character,  you  can  use  numbers  as 
well.  Just  don’t  start  It  with  a number 

■ It  can  be  anything  you  like,  subject  to  those  two 
rules,  just  so  long  as  It  Isn’t  one  of  Java’s  reserved 
words. 


» * l 

i 1 


M^e 


■ 


P 


Tne  w - - hort  inr 

Z-*"00** 


™*Z*r"<*"'*''**'*'' 

If  you  ^ , . F d„ 

R C »-  S-  ■— 


are  keywords  (and  other  things)  that  the  compiler  recognizes.  \ ^ ^ 

.And  if  you  really  want  to  play  coirfuse-a-compiler,  then  just  try  J'*"J 
using  a reserved  word  as  a name. 

You’ve  already  seen  some  reserved  words  when  we  looked  at 
writing  our  first  main  class:  do*U 

public  static  void  , 


* h4o  matter  what  \ 

you  hear,  do  not,  l repeat, 
do  not  let  me  ingest 
another  large  furry  dog. 


And  the  primitive  types  are  reserved  as  well:  ^ 

boolean  char  byte  short  int  long  float  double 

But  there  are  a lot  more  we  haven’t  discussed  yet  Even  if  you  don’t 
need  to  know  what  they  mean,  you  still  need  to  know  you  can’t  use 
'em  yourself.  Do  not-under  any  circumstances-try  to  memorize  these 
mow.  To  make  room  for  these  in  your  head,  you’d  probably  have  to 
lose  something  else.  Like  where  your  car  is  parked.  Don’t  worry,  by 
the  end  of  the  book  you’ll  have  most  of  them  down  cold. 


This  table  reserved. 


booleon 

byte 

char 

double 

float 

Int 

long 

short 

private 

protected 

abstract 

final 

native 

static 

strictfp 

synchronized 

transient 

volatile 

if 

else 

do 

while 

switch 

case 

default 

for 

break 

continue 

assert 

doss 

extends 

implements 

import 

Instanceof 

interface 

new 

package 

super 

this 

catch 

finally 

try 

threw 

throws 

return 

void 

const 

goto 

enum 

Java's  keywords  and  other  reserved  words  (In  no  useful  order).  If  you  use  these  for  names,  the  compiler  will  be  very,  very  upset. 
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Controlling  your  Pog  object 


You  know  how  to  declare  a primitive  variable  and  assign  it  a 
value.  But  now  what  about  non-primitive  variables?  In  other 
words,  what  abcrui  objects  ? 


■ There  is  actually  no  such  thing  as  an  object  variable. 

■ There ’8  only  an  object  reference  variable. 


Dog  d = 
d.bark() 


think  ot 


new  Dog() 

■ 

3 

-this 


like  ihis 


TKink  a Dog 
reforende  variable  as 
a Dog  remote  tonbrol- 
You  it  to  get  tbe 
object  to  do  something 
(invoke  methods). 


■ An  object  reference  variable  holds  bits  that  represent  a 
way  to  access  an  object 

■ It  doesn't  hold  the  object  Itself,  but  it  holds  something 
like  a pointer  Or  an  address.  Except  in  Java  we  don't 
really  know  what  is  inside  a reference  variable.  We  do 
know  that  whatever  it  Is,  It  represents  one  and  only  one 
object  And  the  JVM  knows  how  to  use  the  reference  to 
get  to  the  object 


You  can’t  stuff  an  object  into  a variable.  We  often  think  of 
it  that  way...  we  say  things  like,  “I  passed  the  String  to  die 
System.out.printlnO  method.”  Or,  “The  method  returns  a Dog”, 
or,  “I  put  a new  Foo  object  into  the  variable  named  myFoo.” 

But  that's  not  what  happens.  There  aren’t  giant 
expandable  cups  that  can  grow  to  the  size  of  any 
object.  Objects  live  in  one  place  and  one  place 
only — the  garbage  collectible  heap!  (You’ll 
learn  more  about  that  later  in  this  chapter.) 

Although  a primitive  variable  is  full  of 
bits  representing  the  actual  value  of  the 
variable,  an  object  reference  variable  is  full 
of  bits  representing  a way  to  get  to  the 
object 

You  use  the  dot  operator  (.) 
on  a reference  variable  to  say, 

"use  the  thing  before  the  dot  to 
get  me  the  thing  after  the  dot.”  For 
example: 


myDog.bark() ; 


means,  “use  the  object  referenced  by  the  variable  myDog  to 
invoke  the  bark()  method.”  When  you  use  the  dot  operator  on 
an  object  reference  variable,  think  of  it  like  pressing  a button 
on  the  remote  control  for  that  object. 
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byte  short  irvt  long  reference 

8 16  32  64  (bit  depth  not  relevant) 

An  object  reference  is  just 
another  variable  value. 


The  3 steps  of  object 
declaration,  creation  and 
assignment 


'SogmyDog  = new  Dog()  ; 


O Declare  a reference 
variable 


Something  that  goes  in  a cup. 

Only  this  time,  the  value  is  a remote  control. 


Primitive  Variable 

byte  x = 7; 

^ bits  representing  7 go 
rto  the  variable.  (000001 1 1 ), 


Dog  myDog  = new  Dog()  ; 

Tells  the  JVM  to  allocate  space  for  a 
reference  variable,  and  names  that 
variable  myDog. The  reference  variable 
Is,  forever,  of  type  Dog.  In  other  words, 
a remote  control  that  has  buttons  to 
control  a Dog,  but  not  a Cat  or  a Button 
or  a Socket, 


fctferenee  Variable 

Dog  myDog  = new  DogO  ; 

The  bits  representing  a way  to  get  to 

ifte  Dog  object  go  into  the  variable.  \ 

I I reference 

The  Dog  object  Itself  does  not  go  Into 

\ 1 value 

+e  variable! 

Dog 

i primitive  variables,  the  value  of  the  vari- 
..  the  value  {5,  -2 67,  'a'). 

i reference  variables,  the  value  of  the 
able  iiM.  bits  representing  a way  to  get  to 
aec/fic  object, 

i don't  know  (or  care)  how  any  particular 
implements  object  references.  Sure,  they 
be  a pointer  to  a pointer  to...  but  even 
Fyou  know,  you  still  can't  use  the  bits  for 
thing  other  than  accessing  an  object. 


As  don't  cars  how  meny  1 's  and  0'a  there  are  in  a reference  variable  U‘ 8 up  lo  each 
/.V  and  ihe  phase  of  the  moon. 


o Create  an  object 

Dog  myDog  - new  Dog ()  ; 

Tells  the  JVM  to  allocate  space  for  a 
new  Dog  object  on  the  heap  (we'll 
learn  a lot  more  about  that  process, 
especially  in  chapter  9.) 


Dog  object 


Link  the  object 
and  the  reference 

Dog  myDog  = new  Dog  ( ) ; 

Assigns  the  new  Dog  to  the  reference 
variable  myDog.  In  other  words, 

programs  the  remote  control, 


Dog  object 
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DraflJ^uestions 

How  big  is  a reference 
variable? 

./\^You  don't  know.  Unless 
you're  cozy  with  someone  on  the 
JVM's  development  team, you 
don't  know  how  a reference  Is 
represented. There  are  pointers 
in  there  somewhere,  but  you 
can't  access  them.  You  won't 
need  to.  (OK,  if  you  Insist  you 
might  as  well  just  imagine  it 
to  be  a 64-bit  value.)  But  when 
you're  talking  about  memory 
allocation  issues,  your  Big 
Concern  should  be  about  how 
many  objects  (as  opposed  to 
object  references)  you're  creating, 
and  how  big  they  (the  objects) 
really  are. 


So,  does  that  mean  that 
all  object  references  are  the 
same  size,  regardless  of  the  size 
of  the  actual  objects  to  which 
they  refer? 

Yep.  All  references  for  a 
given  JVM  will  be  the  same 
size  regardless  of  the  objects 
they  reference,  but  each  JVM 
might  have  a different  way  of 
representing  references,  so 
references  on  one  JVM  may  be 
smaller  or  larger  than  references 
on  another  JVM. 

% Can  I do  arithmetic  on  a 
reference  variable,  Increment  It 
you  know -C  stuff? 


Nope.  Say  It  with  me  again, 
"Java  is  note." 


Java  Bxpostd 

This  week's  Interview: 

Object  Reference 

Head  First  So,  tell  us,  what's  life  like  for  an  object  reference? 

Reference:  Pretty  simple,  really.  Pm  a remote  control  and  I can  be  programmed  to 
control  different  objects. 

HeadRrst:  Do  you  mean  different  objects  even  while  you're  running?  like,  can  you 
refer  to  a Dog  and  then  five  minutes  later  refer  to  a Car? 

Reference:  Of  course  not  Once  Pm  declared,  that's  it.  If  I'm  a Dog  remote  control 
then  PU  never  be  able  to  point  (oops  - my  bad,  we're  not  supposed  to  say  point)  I mean  refer 
to  anything  but  a Dog 

HeadRrst:  Does  that  mean  you  can  refer  to  only  one  Dog? 

Reference:  No.  I can  be  referring  to  one  Dog,  and  then  five  minutes  later  I can  refer  to 
some  other  Dog  As  long  as  it's  a Dog  I can  be  redirected  (like  reprogramming  your  remote 
to  a different  TV)  to  it.  Unless...  no  never  mind. 

Head  First:  No,  tel]  me.  What  were  you  gonna  say? 

Reference:  I don't  think  you  want  to  get  into  this  now,  but  I'll  just  give  you  the  short 
version  -if  Fm  marked  as  final,  then  once  I am  assigned  a Dog  I can  never  be  repro- 
grammed to  anything  else  but  that  one  and  only  Dog  In  other  words,  no  other  object  can 
be  assigned  to  me. 

HeadFIrst  You're  right,  we  don’t  want  to  talk  about  that  now.  OK,  so  unless  you're 
final,  then  you  can  refer  to  one  Dog  and  then  refer  to  a different  Dog  later.  Can  you  ever 
refer  to  nothing  at  all?  Is  it  possible  to  not  be  programmed  to  anything? 

Reference:  Yes,  but  it  disturbs  me  to  talk  about  it 
HeadRrst  Why  is  that? 

Reference:  Because  it  means  I'm  null,  and  that’s  upsetting  to  me. 

HeadFIrst:  You  mean,  because  then  you  have  no  value? 

Reference:  Oh,  null  is  a value.  Pm  still  a remote  control,  but  it's  like  you  brought 
home  a new  universal  remote  control  and  you  don't  have  a TV  Pm  not  programmed  to 
control  anything  They  can  press  my  buttons  all  day  long  but  nothing  good  happens.  I 
just  feel  so...  useless.  A waste  of  bits.  Granted,  not  that  many  bits,  but  still.  And  that's  not 
the  worst  part.  If  I am  the  only  reference  to  a particular  object,  and  then  Pm  set  to  nul  1 
(deprogrammed),  it  means  that  now  nobody  can  get  to  that  object  I had  been  referring  to. 

HeadFIrst:  And  that’s  bad  because... 

Reference;  You  have  to  ask?  Here  I’ve  developed  a relationship  with  this  object,  an 
intimate  connecdon,  and  then  the  tie  is  suddenly  cruelly  severed.  And  I will  never  see 
that  object  again,  because  now  it’s  eligible  for  [producer,  cue.  tragic  music]  garbage  collection. 
Sniff.  Bui  do  you  think  programmers  ever  consider  lha£  Snif.  Why  why  can't  I be  a primi- 
tive? I hate  being  a reference.  The  responsibility,  all  the  broken  attachments... 
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Book  b = new  Book  ( ) ; 


■bon  the  garbage-collectible  heap 


Book  c = new  Book  ( ) ; 

Declare  two  Book  reference 
tables.  Create  two  new  Book 
objects*  Assign  the  Book  objects  to 
Wat  reference  variables. 

two  Book  objects  are  now  living 
ar  the  heap. 

steSerences;  2 
Objects:  2 


Book 


Book 


Book  d = c; 

Dedare  a new  Book  reference  variable, 
father  than  creating  a new,  third  Book 
abject,  assign  the  value  of  variable  c to 
variable d.  But  what  does  this  mean? 
r%\\ke  saying, "Take  the  bits  in  c,  make  a 
sopy  of  them,  and  stick  that  copy  Into  d." 

Beth  c and  d refer  to  the  same 
abject. 

The  c and  d variables  hold 
two  different  copies  of  the 
seme  value.  Two  remotes 
programmed  to  one  TV. 

References:  3 

Objects:  2 


Book 


c = b; 

Assign  the  value  of  variable  b to 
variable  e.  By  now  you  know  what 
this  means. The  bits  inside  variable 
6 are  copied,  and  that  new  copy  is 
stuffed  into  variable  c . 

Both  b and  c refer  to  the 
same  object. 

References:  3 
Objects:  2 


Book 
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Life  and  death  on  the  heap 

Book  b = new  Book ( ) ; 

Book  c = new  Book ( ) ; 

Declare  two  Book  reference  variables* 
Create  two  new  Book  objects.  Assign 
the  Book  objects  to  the  reference 
variables. 

The  two  book  objects  are  now  living 
on  the  heap. 

Active  References:  2 
Reachable  Objects:  2 


Book 


b = c; 

Assign  the  value  of  variable  c to  variable  6. 
The  bits  Inside  variable  c are  copied,  and 
that  new  copy  is  stuffed  Into  variable  b. 
Both  variables  hold  identical  values. 

Both  b and  c refer  to  the  same 
object.  Object  1 la  abandoned 
and  eligible  for  Garbage  Collec- 
tion (GO). 

Active  References  2 
Reachable  Objects:  1 
Abandoned  Objects:  1 

The  first  object  that  b referenced  Object  1, 
has  no  more  references.  It's  unreachable . 


c - null; 

Assign  the  value  null  to  variable  r 
This  makes  c a null  reference , meaning 
it  doesn't  refer  to  anything,  But  it's  still 
a reference  variable,  and  another  Book 
object  can  still  be  assigned  to  It. 

Object  2 still  has  an  active 
reference  (b),  and  as  long 
as  It  does,  the  object  is  not 
eligible  for  GC. 

Active  References:  1 
null  References:  1 
Reachable  Objects:  1 
Abandoned  Objects:  1 


Hot  toast 

^(saSeasW"**5 

\ venters  to  ^ 


*u\l  rtkert^ 

(wot 


Book 
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An  array  is  like  a tray  of  oops 

O Declare  an  int  array  variable.  An  array  variable  is 
a remote  control  to  an  array  object. 

int  [ ] mans  ; 

Create  a new  int  array  with  a length 
of  7,  and  assign  it  to  the  previously- 
declared  int  [ ] variable  nums 

nums  = new  int [7] ; 

©Give  each  element  in  the  array 
an  int  value. 

Remember,  elements  in  an  int 
array  are  just  int  variables. 

nums[0]  =6; 
nums [ 1 ] = 19; 
nums  [2]  = 44; 
nums  [3]  = 42; 
nums  [4]  = 10; 
nums [5]  = 20; 
nums  [€]  =1 ; 

Arrays  are  objects  too 

The  Java  standard  library  includes  reference  variable.  Anything  you  Be  sure  to  notice  one  key  thing 

jdcs  of  sophisticated  data  structures  would  put  in  a variable  of  that  type  in  the  picture  above  - the  array  is 

iftduding  maps,  trees,  and  sets  can  be  assigned  to  an  array  element  an  object,  even  though  it's  an  array  of 

$ee  Appendix  B) , but  arrays  are  of  that  type.  So  in  an  array  of  type  primitives, 

F**1  when  you  just  want  a quick,  int  (int[J) , each  element  can  hold  ^ m ^ objectS)  Aether 

ordered,  efficient  list  of  things.  an  int.  In  a Dog  array  (Dog[] ) each  ^ declared  to  hold  primidves 

Arrays  give  you  fast  random  element  can  hold...  a Dog?  No,  or  object  references.  But  you  can 

access  by  letting  you  use  an  index  remember  that  a reference  variable  have  ^ object  ^at's  declared 
position  to  get  to  any  element  in  just  holds  a reference  (a  remote  |0  hM  primidve  in  other 

control),  not  the  object  itself.  So  worcU>  the  array  object  can  have 
fiery  element  in  an  array  isjust  in  a Dog  array,  each  element  can  which  arfi  primitiveS(  5ut 

a variable.  In  other  words,  one  of  "°  ® a TemoU  l^tT0‘' lo  a Dog-  Of  the  array  js  never  a primitive. 

eight  primitive  variable  types  course,  we  so  avetoma  et  e Regardless  of  what  the  array  holds, 

±ink:  Urge  Furry  Dog)  or  a Dog  objects...  and  you  II  see  all  that  the  it5elf  is  „ object, 

° on  the  next  page. 
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an  array  of  objects 


Make  an  array  of  Pog$ 


O Declare  a Dog  array  variable 
Dog[]  pets; 


©Create  a new  Dog  array  with 
a length  of  7,  and  assign  it  to 
the  previously-declared  Dog  [ ] 
variable  pets 

pets  — new  Dog[7] ; 


What's  missing? 

DogsIWe  have  an  array 
of  Dog  references , but  no 
actual  Dog  objects} 


Dog[] 


Dog  array  object  (Dog[]) 


©Create  new  Dog  objects,  and 
assign  them  to  the  array 
elements. 

Remember,  elements  in  a Dog 
array  are  just  Dog  reference 
variables.  We  still  need  Dogs! 


pets[0]  = new  Dog() ; 
pets[l]  = new  Dog() ; 


Dog  array  object  (Dog[]> 


pt^wpen  your  pencil  - 

What  Is  the  current  value  of 
^ts[2]? 

^vpuld  make 
me  of  the 
q objects? 


&og[] 
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Java  cares  aoom  w- 

Once  y°uVeJ^!r^it 

For  ex^p^.Y^^^^^^if'sorneone 

you  cant  st,cl*®h  ^ you  can.  however, 
(spillage,  because  a 

^^•astsC®* 

«•*  ££»«■  «•*  w r 

remember  that  tw  wm?  boSed  o 

put  the  wrong  ^ 

Ke  array's  declared  type. 


Control  your  Pog 

(with  a reference  variable) 

Dog  fido  = now  Dog ( ) ; 

fido.  name  = "Fido" ; 

We  created  a Dog  object  and 
used  the  dot  operator  on  the 
reference  variable  fido  to  access 
the  name  variable.* 

We  can  use  the  fido  reference 
to  get  the  dog  to  bark()  or 
eat()  or  chaseCat(). 

fido , bark ( ) ; 

fido , chaseCat ( ) ; 

What  happens  if  the  Pog  is  in 
a Pog  array? 

We  know  we  can  access  the  Dog’s 
instance  variables  and  methods  using 
tiie  dot  operator,  but  on  what ? 

When  the  Dog  is  in  an  array,  we  don't 
have  an  actual  variable  name  (like 
fido).  Instead  we  use  array  notation  and 
push  the  remote  control  button  (dot 
operator)  on  an  object  at  a particular 
index  (position)  in  the  array: 

Dog[]  myDogs  = new  Dog [3]  ; 
myDogs [0]  = new  Dog()  ; 
myDogs [0] .name  = "Fido"; 


myDogs [0] .bark() ; 


*' Yes  we  know  we’re  not  demonstrating  encapsulation  here,  but  we’re 
trying  to  keep  it  simple.  For  now.  Well  do  encapsulation  in  chapter  4, 
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class  Dog  { 

String  name; 

public  static  void  main  (String []  args)  { 
//  make  a Dog  object  and  access  it 
Dog  dogl  = new  Dog(); 
dogl .bark{)  ; 
dogl. name  = "Bart"; 

//  now  make  a Dog  array 

DogU  myDogs  - new  Dog [3]; 

//  and  put  some  dogs  in  it 
myDogs [0]  - new  Dog  0 ; 
myDogs [1]  ® new  Dog ()  ; 
myDogs [2]  = dogl; 

//  now  access  the  Dogs  using  the  array 
//  references 

myDogs [0] . name  = "Fred"; 
myDogs [ 1 ). name  = "Marge"; 


//  Hmmmm. . . what  is  myDogs [2]  name? 

System. out. print ("last  dog's  name  is  ") ; 
System. out. println (myDogs [2] . name) ; 


//  now  loop  through  the  array 
//  and  tell  all  dogs  to  bark 


int  x = 0; 
while  (x  < myDogs . length)  { 
myDogs [x] .bark<) ; 
x - x + 1;  ***1* 


) 


public  void  bark()  { 

System. out .println (name  f " says  Ruff'"); 

} 

public  void  eat ()  { } 

public  void  cha:seCat()  { ) 


A Pog  example 

Dog  i 


name 


barkO 

eatO 

chaseCatQ 


Output 

|~Rle  Edit Wmdw  Rdp  HowT  ~ I 


%java  Dog 
null  says  Ruff? 
last  dog' s name  is  Bart 
Fred  says  Ruff! 

Marge  says  Ruff! 

Bart  says  Ruff? 


BULLET  POINTS  

■ Variables  come  in  two  flavors:  primitive  and 
reference. 

■ Variables  must  always  be  declared  with  a name 
and  a type. 

■ A primitive  variable  value  is  the  bits  representing 
the  value  (5,  ’a',  true,  3,1416,  etc.). 

■ A reference  variable  value  is  the  bits 
representing  a way  to  get  to  an  object  on  the 
heap. 

■ A reference  variable  is  like  a remote  control. 
Using  the  dot  operator  (.)  on  a reference 
variable  is  like  pressing  a button  on  the  remote 
control  to  access  a method  or  instance  variable. 

■ Areference  variable  has  a value  of  null  when 
it  is  not  referencing  any  object 

■ An  array  is  always  an  object,  even  if  the'  array 
is  declared  to  hold  primitives.  There  is  no  such 
thing  as  a primitive  array,  only  an  array  that 
holds  primitives. 
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RClft 


BE  th&  comber 


Each  of  the  Java  files  on  this  page 
represents  a complete  source  file. 
Your  job  is  to  play  compiler  and 
PC  determine  whether  each  of  these  files 
_ will  compile.  If  they  won’t 
compile,  how  would  you 
fix  diem? 


A 

class  Books  { 

String  title; 

String  author; 

} 

class  BooksTestDrive  { 
public  static  void  main (String  []  args)  { 

Books  (]  myBooks  = new  Books[3); 
int  x = 0; 

myBooks[Q]  * title  = "The  Grapes  of  Java"; 
myBooks [ 1] -title  = "The  Java  Gatsby"? 
myBooks[2] .title  = "The  Java  Cookbook"; 
myBooks(O) .author  = "bob"; 
myBooks (1J. author  - "sue"; 
myBooks [2 ] .author  = "ian"; 

while  (x  < 3)  { 

System. out. print(my8ooks[x) .title) ; 
System. out. print ("  by  "); 

System . out . println { myBooks [ x ] . author ) ; 
x = x + 1; 

) 

} 


B 

class  Hobbits  { 

String  name; 

public  static  void  main{String  []  args)  { 

Hobbits  []  h = new  Hobbits[3); 
int  2=0; 

while  (z  < 4)  { 
z = z + 1; 

h[z]  = new  Hobbits(); 
h[z] .name  = "bilbo"; 
if  (z  ==  1}  { 
h[z].name  = "frodo"; 

> 

if  (z  ==  2)  { 
h[z].name  = “sam"; 

} 

System. out.print(h[ 2] .name  + " is  a "); 
System. out. println ("good  Hobbit  name”); 

} 

} 

) 
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exercise:  Code  Magnets 


Code  Magnets 


QA  working  Java  program  Is  all  scrambled  up 
on  the  fridge.  Can  you  reconstruct  the  code 
snippets  to  make  a working  Java  program 
that  produces  the  output  listed  below? 
Some  of  the  curly  braces  fell  on  the  floor 
and  they  were  too  small  to  pick  up,  so  feel 
j free  to  add  as  many  of  those  as  you  need! 


int  y 


ref  = index[y]; 


^nds[o  j 


"Bermuda 


int  ref; 
while  (y  < 4)  { 

System. out . println { islands [ ref ] ) 


Lndex[  0 1 

index [11 

indent  ^ ^ 

index [ 3 1 


String  []  islands  = new  String[4]; 


System. out. print ( "island  = 


lnt  f J index 


nev  intf4J 


fle  E « Wrtor  Help  fort 


java  TestArrays 
island  = Fiji 
island  = Cozumel 
island  = Bermuda 
island  = Azores 


class  TestArrays { ~ 

pubUo  stdtio  void  main(String  ( , , 
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P$$I  Puzzje 


Your  Job  is  to  take  code  snippets  from 
the  pool  and  place  them  into  the 
blank  lines  in  the  code. You  may 
use  the  same  snippet  more  than 
once,  and  you  won't  need  to  use 
all  the  snippets.  Your  goal  is  to 
make  a class  that  will  compile  and 
run  and  produce  the  output  listed. 


A 'i  » Se?ar 


class  Triangle  { 
double  area; 
int  height; 
int  length; 
public  static  void  main(String  []  args)  { 


****** 


ate 

to 


while  ( ) { 


.height  = (x  + 1)  * 2; 
•length  = x + 4; 


Output 


rplle  Ed^^^windaw^^HeIp^6m^ud^^^^^^^^ 


%java  Triangle 

triangle  0, 

area  =4.0 

triangle  1 , 

area  =10.0 

triangle  2, 

area  = 18,0 

triangle  3, 
v = 

area  = 

Bonus  Question! 

For  extra  bonus  points,  use  snippets 
from  the  pool  to  fill  in  the  missing 
output  (above). 


Sy stem. out. print ( " triangle  "+x+"y  area"); 
Sy stem. out • println ( " - " + .area); 


> 


x = 27; 

Triangle  t5  = ta[2]; 
ta[2).area  = 343; 

Sys tern. out .print (*y  = " + y); 

System. out. print In (M , t5  area  - "+  tS.area); 

> 

void  setArea{)  { 

= (height  * length)  / 2; 

> 


' area 
ta.area 
tajearea 
ta(x].area 


4,  t5  area  = 18,0 
4,  t5  area  = 343.0 
27,  t5  area  = 18,0 
27,  t5  area  = 343.0 


r Triangle  [ ] ta  = newTrlangle(4); 
Triangle  ta  = new  [ ] Triangle[4); 
Triangle  [ ) ta  = newTriangte[4]; 


ta(x]  = setAreaO; 
ta.x  = setAreaO; 
ta(x).setArea(); 


Note:  Each  snippet 
from  the  pool  can  be 
used  more  than  oncel 


int  x; 

— 1 

Int  y; 

x = x + 1 ; 

tajc 

int  x = 0; 

x = x + 2; 

ta(x) 

Int  x = 1; 
int  y = x; 

X = X -1; 

ta{x] 

ta[x]  = new  Triangle!); 
ta.x  = new  Triangle!); 
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puzzle:  Heap  o’  Trouble 


A Heap  o'  Trouble 

A short  Java  program  is  listed  to  the 
right.  When  7/  do  stuff  is  reached,  some 
objects  and  some  reference  variables 
will  have  been  created.  Your  task  is 
to  determine  which  of  the  reference 
variables  refer  to  which  objects.  Not  all 
the  reference  variables  will  be  used, and 
some  objects  might  be  referred  to  more 
than  once.  Draw  lines  connecting  the 
reference  variables  with  their  matching 
objects. 

Tip:  Unless  you're  way  smarter  than  us, 
you  probably  need  to  draw  diagrams 
like  the  ones  on  page  55  and  56  of  this 
chapter.  Use  a pencil  so  you  can  draw 
and  then  erase  reference  links  (the 
arrows  going  from  a reference  remote 
control  to  an  object). 


class  HeapQuiz  { 
int  id  = 0; 

public  static  void  main (String  []  args)  { 
int  x = 0; 

HeapQuiz  [ ] hq  = new  HeapQuiz[5]; 
while  ( x < 3 ) ( 

hq[x]  = new  HeapQuiz (); 
hq  [x]  . id  = x; 
x = x + 1; 

) 

hq [ 3]  = hq [ 1 ] ; 
hq[4]  = hq [ 1 ] ; 
hq[3]  = null; 
hq [ 4 ] = hq [ 0 ] ; 
hq[0]  = hq  1 3 ] ; 
hq  [ 3 ] = hq [ 2 ] ; 
hq [ 2 ] = hq [ 0 ) ; 

//  do  stuff 

) 

} 


Reference  Variables: 


titV  rA***1 
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pve-lvgnufe 
Mystery 


The  case  of  the  pilfered  references 

It  was  a dark  and  stormy  night  Tawny  strolled  into  the  programmers’  bullpen  like  she 
owned  the  place.  She  knew  that  all  the  programmers  would  still  be  hard  at  work,  and  she 
wanted  help.  She  needed  a new  method  added  to  the  pivotal  class  that  was  to  be  loaded  into  the 
client's  new  top-secret  Java-enabled  cell  phone.  Heap  space  in  the  cell  phone’s  memory  was 
as  tight  as  Tawny’s  top,  and  everyone  knew  it  The  normally  raucous  buzz  in  the  bullpen  fell  to 
silence  as  Tawny  eased  her  way  to  the  white  board  She  sketched  a quick  overview  of  the  new 
method’s  functionality  and  slowly  scanned  the  room,  ‘Well  boys,  it’s  crunch  time",  she  purred 
'"Whoever  creates  the  most  memory  efficient  version  of  this  method  is  coming  with  me  to  the 
client’s  launch  party  on  Maui  tomorrow...  to  help  me  install  the  new  software." 

The  next  morning  Tawny  glided  into  the  bullpen  wearing  her  short  Aloha  dress. 

1 ‘Gentlemen",  she  smiled,  “the  plane  leaves  in  a few  hours,  show  me  what  you’ve 
got!”  Bob  went  first;  as  he  began  to  sketch  his  design  on  the  white  board  Tawny 
said,  “Let’s  get  to  the  point  Bob,  show  me  how  you  handled  updating  the  list  of  con- 
tact objects  " Bob  quickly  drew  a code  fragment  on  the  board: 


Contact  [ ) ca  = new  Contact ( 10 J; 
while  ( x < 10  ) { //  make  10  contact  objects 

cafx)  = new  Contact  0; 
x = x + 1; 

} 

II  do  complicated  Contact  list  updating  stuff  with  ca 


“Tawny  1 know  we’re  tight  on  memory,  but  your  spec  said  that  we  had  to  be  able  to  access 
individual  contact  information  for  all  ten  allowable  contacts,  this  was  the  best  scheme  I could 
cook  up",  said  Bob.  Kent  was  next,  already  imagining  coconut  cocktails  with  Tawny,  "Bob,” 
he  said,  “your  solution’s  a bit  kludgy  don’t  you  think?"  Kent  smirked,  ‘Take  a look  at  this 
baby": 


Contact  refc; 

while  ( x < 10  ) { If  make  10  contact  objects 
refc  = new  Contact!); 
x = x + 1; 

} 

II  do  complicated  Contact  list  updating  stuff  with  refc 

“I  saved  a bunch  of  reference  variables  worth  of  memory,  Bob-o-rino,  so  put  away  your 
sunscreen”,  mocked  Kent  lfNot  so  fast  Kent!”,  said  Tawny,  “y°u>ve  saved  a little  memory,  but 
Bob’s  coming  with  me." 

Why  did  Tawny  choose  Bob’s  method  over  Kent%  when  Kent’s  used  less  memory? 
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#*» 


Exercise  Solutions 


Code  Magnets: 

class  TestArrays  { 

public  static  void  main (String  (]  args)  { 
int  []  index  = new  int{4]; 
index[0]  = 1; 
indexfl]  = 3; 
index [ 2 ] = 0; 
index [3 ] = 2; 

String  (]  islands  - new  String[4J; 
islands  [0]  = "Bermuda"; 
islands!  1 ] = "Fiji''; 
islands(2]  = "Azores"; 
islandsf 3]  = "Cozumel"; 
int  y = 0; 
int  ref; 
while  ( y < 4 ) { 
ref  = indax[y ] ; 

System. out .print ( "island  = 

System. out .pr intin ( islands [ ref ] ) ; 

y - y + l; 

> 

} 

} Re  Edit  Window  Help 


\ java  TestArrays 
island  = Fiji 
island  = Cozumel 
island  = Bermuda 
island  = Azores 


class  Books  { 

String  title; 

String  author; 

class  BooksTestDrive  ( 

public  static  void  main( String  []  args)  { 
Books  [ J myBooks  » new  Books [ 3 ) ; 
int  x = 0; 

mySooks[0]  = new  SooksO; 
myBooks[l]  = new  BooksO; 
my6ooks[2]  - new  BooksQ; 

myBooks[0] -title  = "The 
myBooks(l] -title  = "The 
myBooks(2] .title  = "The 
myBooksfO] -author  = "bob"; 
myBooks( 1] -author  - "sue"; 
myBooks ( 2 ]. author  = "ian"; 
while  (x  < 3)  { 

System.out- print (myBooks! x) - title) ; 

Sy stem - out -pr int ("  by  "); 
System,out.println(myBooks[x] .author) ; 
x - x + 1; 

) 

) 


class  Hobbits  ( 

String  name; 
public  static  void  main(String  []  args)  < 
Hobbits  [)  h = new  Hobbits[3); 

Int  l - - 1 ; 
while  (z  c 2)  ( 
z = z + l; 
h[z]  * new  Bobbits( ) ; 
j h(z].name  = "bilbo"; 
if  ( z ==  1)  { 
h[z ] -name  = "frodo"; 

} 

if  (Z  ==  2)  { 

h[z] .name  = "sam"; 

) 

Sy stem. out. pr int (h( z) .name  + " is  a "); 
Sy stem. out. println( "good  Hobbit  name"); 

> 

) 

} 


Remember:  arrays  start  with 
element  0 ) 


Remember:  We  have  to 
actually  make  the  Books 
objects  I 

Grapes  of  Java"; 

Java  Gatsby"; 

Java  Cookbook"; 
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Puzzle  Solutions 


claas  Triangle  { 
double  area; 
int  height; 

Int  length; 

public  static  void  main (String  []  arga ) { 

Int  x = 0: 

Triangle  [ ] ta  = new  Triangle [4]; 

while  ( x < 4 ) { 
ta[x]  = new  THongieQ: 
talx].  height  « (x  + 1)  * 2y 
tafx].  length  = x + 4; 
ta(x].setAreaO; 

System * out * print triangle  “+x+"(  area”) ; 
Sy3tem*out.println(^  * H + to{x].area); 
x = x ♦ 1; 

> 

Int  y = x; 

x - 27; 

Triangle  t5  *=  ta[2j; 
ta[ 2 ] - area  = 343; 

System. out. print ( *y  = " + y); 

System. out. println( % t5  area  * "+  tS.area); 

> 

void  aetArea()  { 

area  = (height  * length)  / 2; 


i java  Tri 

tangle 

triangle 

0, 

area  = 

4.0 

triangle 

1, 

area  = 

10.0 

triangle 

2. 

area  - 

ia.o 

triangle 

3 , 

area  = 

26.0 

y = 4,  t5 

area  - 343 

The  case  of  the  pilfered  references 

Tawny  could  see  that  Rent's  method  had  a serious 
flaw.  It's  true  that  he  didn't  use  as  many  reference 
variables  as  Bob,  but  there  was  no  way  to  access  any 
but  the  last  of  the  Contact  objects  that  his  method  cre- 
ated. With  each  trip  through  the  loop,  he  was  assign- 
ing a new  object  to  the  one  reference  variable,  so  the 
previously  referenced  object  was  abandoned  on  the 
heap  - unreachable.  Without  access  to  nine  of  the  ten 
objects  created,  Kent's  method  was  useless. 

(The  software  was  a huge  success  and  the  dtent  gave  Tawny  and  Bob  an  extra  week 
h Hawaii.  Wad  like  to  tell  you  that  by  finishing  this  book  you  too  wfll  get  stuff  like  that) 


Reference  Variables:  HeapQuJz  Objects: 
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How  Objects  Behave 


State  affects  behavior,  behavior  affects  state.  We  know  that  objects 

have  state  and  behavior  represented  by  instance  variables  and  methods.  But  until  now,  we 
haven't  looked  at  how  state  and  behavior  are  related.  We  already  know  that  each  instance  of  a 
class  (each  object  of  a particular  type)  can  have  its  own  unique  values  for  its  instance  variables. 
Dog  A can  have  a name  "Fido" and  a weight  of  70  pounds.  Dog  8 Is^lller'and  weighs  9 pounds. 
And  If  the  Dog  class  has  a method  makeNoise(),well,  don't  you  think  a 70-pound  dog  barks  a 
bit  deeper  than  the  little  9-pounder?  (Assuming  that  annoying  yippy  sound  can  be  considered 
a bark.)  Fortunately,  that's  the  whole  point  of  an  object— it  has  behavior  that  acts  on  its  state.  In 
other  words,  methods  use  Instance  variable  values.  Like, "if  dog  Is  less  than  14  pounds,make 
yippy  sound,  else..."  or  “Increase  weight  by  5"  Let's  go  change  some  state. 
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objects  have  state  and  behavior 


Remember:  a class  describes  what  an 
object  knows  and  what  an  object  does 


A class  is  the  blueprint  for  an  object*  When  you 
write  a class,  you're  describing  how  the  JVM 
should  make  an  object  of  that  type.  You  already 
know  that  every  object  of  that  type  can  have 
different  instance  variable  values.  But  what  about 
the  methods? 

Can  every  object  of  that  type  have  different 
method  behavior? 


instance 

variables 

(state) 

methods 

(behavior) 


Song 


title 

artist 


setTltleO 

setArtist() 

playQ 


knows 

does 


Well...  sort  of,* 

Every  instance  of  a particular  class  has  the  same 
methods,  but  the  methods  can  behave  differently 
based  on  the  value  of  the  instance  variables. 

The  Song  class  has  two  instance  variables,  title 
and  artist  The  play()  method  plays  a song,  but 
the  instance  you  call  play()  on  will  play  the  song 
represented  by  the  value  of  the  title  instance 
variable  for  that  instance.  So,  if  you  call  the  play() 
method  on  one  instance  you’ll  hear  the  song 
“Politik”,  while  another  instance  plays  “Darkstar”. 
The  method  code,  however,  is  the  same. 

void  play ()  { 

soundPlayer. play Sound (title) ; 

> 


£ e,\a*  ^ 


Song  t2  = new  Song(); 
t2 . setArtist ("Travis") ; 
t2 . setTitle ("Sing") ; 

Song  s3  = new  Song(); 

s3 . setArtist (“Sex  Pistols") 

s3 . setTitle ("My  Way") ; 


Song 

1 2 .play() 


Song 

s3 .play  ()  ; 

r 

Ca,lih5  ftyU  or  this 

Will  63USC  “Aty  ivay"  ^ p|ay. 
fbui  wrt  ihe  Sintra  o*«) 


'Yes.  another  stunningly  clear  answer! 
72  chapter  4 


methods  use  instance  variables 


le  size  affects  the  bark 

[ Dog’s  bark  is  different  from  a big  Dog  s bark. 

f Dog  class  has  an  instance  variable  size,  that  the 
f - method  uses  to  decide  what  kind  of  bark  sound 


'sold  bark()  { 

[ if  (size  > 60)  ( 

System. out . println ("Wooof ! Wooof ! " ) ; 
[ > else  if  (size  > 14)  { 

System . out . println ("Ruff  1 Ruff!") ; 

) else  f 

System. out .println ("Yip!  Yip! ") ; 


} 


c| ess  DogTestDrive  ( 

public  static  void  main  (String!)  args)  f 
Dog  one  = new  DogO; 
one-size  = Y0; 

Dog  two  = new  Dog ( ) ; 
two .size  = 8; 

Dog  three  = new  DogO; 
three-size  = 35; 

one. bark () ; 
two .bark () ; 
three. bark () ; 


Fite  Edit  Window  H&lp  Playd&ad 


%java  DogTestDrive 
Wooof!  Wooof! 

Yip!  Yip! 

Ruff!  Ruff! 
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method  parameters 


You  can  send  things  to  a method 

Just  as  you  expect  from  any  programming  language,  you  can  pass  values  into 
your  methods.  You  might,  for  example,  want  to  tell  a Dog  object  how  many 
times  to  bark  by  calling: 

d. bark (3) ; 

Depending  on  your  programming  background  and  personal  preferences, 
you  might  use  the  term  arguments  or  perhaps  parameters  for  the  values  passed 
into  a method.  Although  there  on?  formal  computer  science  distinctions  that 
people  who  wear  lab  coats  and  who  will  almost  certainly  not  read  this  book, 
make,  we  have  bigger  fish  to  fry  in  this  book.  So  you  can  call  them  whatever 
you  like  (arguments,  donuts,  hairballs,  etc.)  but  we're  doing  it  like  this: 

A method  uses  parameters.  A caller  passes  arguments. 

Arguments  are  the  things  you  pass  into  the  methods.  An  argument  (a  value 
like  2,  wFoow,  or  a reference  to  a Dog)  lands  face-down  into  a...  wait  for  it.. 
parameter . And  a parameter  is  nothing  more  than  a local  variable.  A variable 
with  a type  and  a name,  that  can  be  used  inside  the  body  of  the  method 

But  here's  the  important  part:  If  a method  takes  a parameter,  you  must  pass 
it  something.  And  that  something  must  be  a value  of  the  appropriate  type. 


Call  the  bark  method  on  the  Dog  refer- 
ence, and  pass  in  the  value  3 (as  the 
argument  to  the  method). 


Dog  d = new  Dog() 
d.bark (3) ; 

avywriewt 


The  bits  representing  the  int 
value  3 are  delivered  into  the 
bark  method. 


void  bark  (int  numOraarks)  { 


The  bits  land  in  the  numOf  Barks 


parameter  {an  int-sized  variable). 


while  (nuraOfBarks  >0)  { 

System. out . println ("ruff") ; 

numOfBarks  = numOfBarks  - 1; 


OUse  the  numOf  Barks 

parameter  as  a variable  in 
the  method  code. 


} 


} 
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You  can  get  things  back  front  a method. 


Methods  can  return  values.  Every  method  is  declared  with  a return 
but  until  now  we’ve  made  all  of  our  methods  with  a void 
rcm m type,  which  means  they  don’t  give  anything  back. 


■sold  go  ( ) { 

1 

we  can  declare  a method  to  give  a specific  type 
tack  to  the  caller,  such  as: 

Z2.Z  giveSecret()  { 

return  42; 


declare  a method  to  return  a value,  you  must 
aetnma  value  of  the  declared  type!  (Or  a value 
joi  ts  compatible  wi\h  the  declared  type.  We’ll  get 
iK*  that  more  when  we  talk  about  polymorphism 
it  chapter  7 and  chapter  8.) 

Whatever  you  say 
you’ll  give  back,  you 
better  give  back! 


The  Compiler  won,-t  let  you  return  -the  wron^  ■type  o-f  thiyijy 


int  the^cret  = life.giveSecret()  ; 


K \ 


return (42 

■this  mwrt 


m 


tr'l  art  «W*  (r°" 


int  giveSectet()  { TV  w4 


<jana 
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multiple  arguments 


You  can  send  wore  than  one  thing 
to  a method 

Methods  can  have  multiple  parameters.  Separate  them 
with  commas  when  you  declare  them,  and  separate  the 
arguments  with  commas  when  you  pass  them.  Most 
importantly,  if  a method  has  parameters,  you  must  pass 
arguments  of  the  right  type  and  order 

Calling  a two-parameter  method,  and  sending 
It  two  arguments. 

void  go  ( ) { 

Tests tuff  t = new  TestStuff ( ) ; 


t . t&keTwo ( 12 , 34) ; 


***■  p*sj  ^ ^ 

^ Ud, 


void  takeTwo(int  x,  int  y)  { 
int  z = x + y; 

System,  out. prin tin  ("Total  is  " + z)  ; 


You  can  pass  variables  Into  a method,  as  long  as 
the  variable  type  matohes  the  parameter  type. 


void  go()  ( 

int  foo  = 7; 
int  bar  = 3; 
t . takeTwo  (foo,  bar); 


void  takeTwo (int  x,  int  y)  { 
int  z = x + y; 

System,  out.  println  ("Total  is  " + z)  ; 


, c l-t's  the  s*** 

wwt.  tkf .’'jj  tf  aW"1  to° A 

’I*4.''1  ' „„,,i 
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Java  is  pass-by-value. 
That  means  pass-by-copy. 


int  x = 7; 


Declare  an  int  varrable  and  assign  it 
the  value  'T.  The  bit  pattern  for  7 
goes  into  the  variable  named  x. 


void  go (int  z) { 


Declare  a method  with  an  int 
parameter  named  z. 


int  int 

foo.go (x) ; void  3°<int  ■>< 


©Call  the  go()  method,  passing 
the  variable  x as  the  argument. 
The  bits  in  x are  copied,  and 
the  copy  lands  in  z. 

} 


O*,3' 


©Change  the  value  of  z inside 
the  method.  The  value  of  x 
doesn't  change!  The  argument 
passed  to  the  z parameter  was 
only  a copy  of  x. 

The  method  can't  change  the 
bits  that  were  in  the  calling 
variable  x. 
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arguments  and  return  values 


Q/  What  happens  If  the  argument  you  want  to 
pass  Is  an  object  Instead  of  a primitive? 

Awou'll  learn  more  about  this  in  later  chapters, 
but  you  already  know  the  answer.  Java  passes 
everything  by  value.  Everything.  But...  value  means 
bits  Inside  the  variable*  And  remember,  you  don't 
stuff  objects  Into  variables;  the  variable  Is  a remote 
control — a reference  fo  an  object . So  if  you  pass  a 
reference  to  an  object  into  a method, you're  passing 
a copy  of  the  remote  control.  Stay  tuned,  though,  we'll 
have  lots  more  to  say  about  this. 


Q/  Can  a method  declare  multiple  return  values? 
Or  Is  there  some  way  to  return  more  than  one 
value? 


A- 

*1-  Sort  of.  A method  can  declare  only  one  return 
value.  BUT...  If  you  want  to  return,  say,  three  int  values, 
then  the  declared  return  type  can  be  an  Int  array. 
Stuff  those  Ints  Into  the  array,  and  pass  it  on  back.  It's 
a little  more  involved  to  return  multiple  values  with 
different  types;  we'll  be  talking  about  that  in  a later 
chapter  when  we  talk  about  ArrayLIst. 


Do  I have  to  return  the  exact  type  I declared? 


A- 

You  can  return  anything  that  can  be  implicitly 
promoted  to  that  type. So,  you  can  pass  a byte  where 
an  Int  is  expected. The  caller  won't  care,  because  the 
byte  fits  Just  fine  into  the  Int  the  caller  will  use  for 
assigning  the  result.  You  must  use  an  explicit  cast 
when  the  declared  type  is  smaller  than  what  you're 
trying  to  return. 


Do  I have  to  do  something  with  the  return 
value  of  a method?  Can  I just  Ignore  K? 


Aa Java  doesn't  require  you  to  acknowledge  a 
return  value.  You  might  want  to  cal!  a method  with 
a non-void  return  type,  even  though  you  don't  care 
about  the  return  value.  In  this  case, you're  calling 
the  method  for  the  work  it  does  inside  the  method, 
rather  than  for  what  the  method  gives  returns . In 
Java, you  don't  have  to  assign  or  use  the  return  value. 
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//Reminder:  Java 
cares  about  type! 

You  can’t  return  a Giraffe  when 
the  return  type  Is  declared 
as  a Rabbit.  Same  thing  with 
parameters.  You  can’t  pass  a 
Giraffe  into  a method  that 
ip^  takes  a Rabbit. 


BULLET  POINTS  

■ Classes  define  what  an  object  knows  and  what  an 
object  does. 

■ Things  an  object  knows  are  its  instance  variables 
(state). 

■ Things  an  object  does  are  its  methods  (behavior). 

■ Methods  can  use  instance  variables  so  that  objects 
of  the  same  type  can  behave  differently. 

■ A method  can  have  parameters,  which  means  you 
can  pass  one  or  more  values  in  to  the  method. 

■ The  number  and  type  of  values  you  pass  in  must 
match  the  order  and  type  of  the  parameters 
declared  by  the  method. 

■ Values  passed  in  and  out  of  methods  can  be 
implicitly  promoted  to  a larger  type  or  explicitly  cast 
to  a smaller  type. 

■ The  value  you  pass  as  an  argument  to  a method 
can  be  a literal  value  (2,  'c\  etc.)  or  a variable  of 
the  declared  parameter  type  (for  example,  x where 
x is  an  int  variable).  (There  are  other  things  you 
can  pass  as  arguments,  but  we’re  not  there  yet.) 

■ A method  must  declare  a return  type.  A void  return 
type  means  the  method  doesn't  return  anything. 

■ If  a method  declares  a non-void  return  type,  it  must 
return  a value  compatible  with  the  declared  return 
type. 
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things  you  can  do  with  parameters 
return  types 

i we’ve  seen  how  parameters  and  return  types  work,  it’s 
> pal  them  to  good  use:  Getters  and  Setters.  If  you’re  into 
li  formal  about  it,  you  might  prefer  to  call  them  Accessors 
. But  that’s  a waste  of  perfecdy  good  syllables. 

, Getters  and  Setters  fits  the  Java  naming  convention,  so 
* well  call  them. 

i and  Setters  let  you,  well,  get  and  set  things.  Instance  vari- 
. usually.  A Getter’s  sole  purpose  in  life  is  to  send  back, 
t value,  the  value  of  whatever  it  is  that  particular  Getter 
! to  be  Getting.  And  by  now,  it’s  probably  no  surprise 


i Setter  lives  and  breathes  for  the  chance  to  take  an  argu- 
* and  use  it  to  set  the  value  of  an  instance  variable. 


mi  EloctricGuitar  { 

Spring  brand; 
inr  numOfPickups; 
boolean  rocks  tarUsealt; 

String  g© tBrand  ( ) { 

return  brand; 


ElectricGuitar 


brand 

numOfPickups 

rockStarUsesli 


getflrandQ 

setBrand{) 

getNumOfPickupsQ 

setNumOfFickups{) 

getRockStarUsesItQ 

satRockStarUseslt() 


Hob-  W*!^^*** 

I*ea*»'rttbe 

sta^a>r<J! 


void  a© tBrand  (String  aBrand)  { 
brand  = aBrand; 


I ■&  gstNumOf Pickups ()  { 

return  numOfPickups; 


vc id  setNumOf Pickups  (int  nua)  { 
numOfPickups  = num; 


getRockStarUsesIt ()  { 
return  rockStarUsosIt ; 


id  setRockStarUsealt (boolean  yesOrNo)  ( 
roekStartJsesIt  = yesOrNo ; 
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real  developers  encapsulate 


Encapsulation 


Po  it  or  risk  humiliation  and 
ridicule. 

Until  this  most  important  moment,  we’ve 
been  committing  one  of  the  worst  OO 
faux  pas  (and  we're  not  talking  minor 
violation  like  showing  up  without  the  *B' 
in  BYOB).  No,  we‘re  talking  Faux  Pas  with 
a capital  'F\  And  *P\ 

Our  shameful  transgression? 

Exposing  our  daial 

Here  we  are,  just  humming  along  without 
a care  in  die  world  leaving  our  data  out 
there  for  anyone  to  see  and  even  touch. 

You  may  have  already  experienced  that 
vaguely  unsettling  feeling  that  comes  with 
leaving  your  instance  variables  exposed. 

Exposed  means  reachable  with  the  dot 
operator,  as  in: 

theCat , height  = 27; 


.Think  about  this  idea  of  using  our  remote 
control  to  make  a direct  change  to  the  Cat 
object’s  size  instance  variable.  In  the  hands 
of  the  wrong  person,  a reference  variable 
(remote  control)  is  quite  a dangerous 
weapon.  Because  what’s  to  prevent: 

theCat . height  = 0;  \et  ^ 


This  would  be  a Bad  Thing.  We  need  to 
build  setter  methods  for  all  the  instance 
variables,  and  find  a way  to  force  other 
code  to  call  the  setters  rather  than  access 
the  data  directly 


public  void  setHeight (int  ht)  { 
if  (ht  > »)  { s 

height  = ht;  * r4*  ** 

} 

> 


*•  **»*«* 
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He  the  data 

ii  is  that  simple  to  go  from 
U;  implementation  that's  just 
pegging  for  bad  data  to  one 
tLi i protects  your  data  and 
protects  your  right  to  modify 
fotsr  implementation  later. 

OS.  so  how  exactly  do  you 
tide  the  data?  With  the 
poblic  and  private 
access  modifiers.  You're 
^miliar  with  publio-we  use 
i with  every  main  method. 

He  ire’s  an  encapsulation 
merUr  rule  of  thumb  {all  stan- 
dard disclaimers  about  rules 
a£ rhumb  are  in  effect):  mark 
join  instance  variables  private 
■d  provide  public  getters 
1 vd.  setters  for  access  control 
When  you  have  more  design 
coding  savvy  in  Java,  you 
probably  do  things  a little 
dceirently,  but  for  now,  this 
^proach  will  keep  you  safe. 


Mark  instance 
variables  private. 


Mark  getters  and 
setters  public. 


"Sadly,  Sill  forgot  to 
encapsulate  his  Cat  class  and 
ended  up  with  a flat  cat." 

(overheard  at  the  water  cooler). 


Java  Exposed: 

This  week’s  Interview: 

An  Object  gets  candid  about  encapsulation. 
Head  First  What’s  the  big  deal  about  encapsulation? 

Object  OK,  you  know  that  dream  where  you’re  giving  a talk  to  500  people  when  you 
suddenly  realize-  you’re  naked? 

HeadFirst  Yeah,  we’ve  had  that  one.  It’s  right  up  there  with  the  one  about  the  Pilates 
machine  and,,,  no,  we  won’t  go  there.  OK,  so  you  feel  naked.  But  other  than  being  a little 
exposed,  is  there  any  danger? 

Object  Is  there  any  danger?  Is  there  any  danger ? [starts  laughing]  Hey,  did  all  you  other 
instances  hear  that,  “Is  there  wry  danger?”  he  asks?  [falls  on  the  floor  laughing) 

HeadFirst  What’s  funny  about  that?  Seems  like  a reasonable  question. 

Object  OK,  I'll  explain  it.  It’s  [bursts  out  laughing  again,  uncontrollably] 

HeadFirst  Can  I get  you  anything?  Water? 

Object  Whew!  Oh  boy.  No  I’m  fine,  really  I’ll  be  serious.  Deep  breath.  OK,  go  on. 
HeadFirst  So  what  does  encapsulation  protect  you  from? 

Object  Encapsulation  puts  a force-field  around  my  instance  variables,  so  nobody  can  set 
them  to,  let’s  say,  something  inappropriate. 

HeadFirst  Can  you  give  me  an  example? 

Object  Doesn’t  take  a PhD  here.  Most  instance  variable  values  are  coded  with  certain 
assumptions  about  the  boundaries  of  the  values.  Like,  think  of  all  the  things  that  would 
break  if  negative  numbers  were  allowed  Number  of  bathrooms  in  an  office-  Velocity  of 
an  airplane.  Birthdays.  Barbell  weight  Cell  phone  numbers.  Microwave  oven  power 

HeadFirst  I see  what  you  mean.  So  how  does  encapsulation  let  you  set  boundaries? 

Object  By  forcing  other  code  to  go  through  setter  methods.  That  way  the  setter  method 
can  validate  the  parameter  and  decide  if  ids  do-able.  Maybe  the  method  will  reject  it  and 
do  nothing,  or  maybe  it’ll  throw  an  Exception  (like  if  ids  a null  social  security  number 
for  a credit  card  application),  or  maybe  the  method  will  round  the  parameter  sent  in  to 
the  nearest  acceptable  value.  The  point  is,  you  can  do  whatever  you  want  in  the  setter 
method,  whereas  you  can’t  do  anything  if  your  instance  variables  are  public. 

HeadFirst:  But  sometimes  I see  setter  methods  that  simply  set  the  value  without  check- 
ing anything  If  you  have  an  instance  variable  that  doesn't  have  a boundary,  doesn’t  that 
setter  method  create  unnecessary  overhead?  A performance  hit? 

Object  The  point  to  setters  (and  getters,  too)  is  that  you  can  change  your  rrund  later , 

; without  breaking  anybody  else's  code! Imagine  if  half  the  people  in  your  com- 
pany used  your  class  with  public  instance  variables,  and  one  day  you  suddenly  realized, 
“Oops-  there’s  something  I didn’t  plan  for  with  that  value,  I’m  going  to  have  to  switch  to  a 
setter  method”  You  break  everyone’s  code.  The  oool  thing  about  encapsulation  ls  thatjxw/ 
get  to  change  your  mind.  And  nobody  gets  hurt  The  performance  gain  from  using  variables 
directly  is  so  miniscule  and  would  rarely — if  ever—  be  worth  iL 
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how  objects  behave 


Encapsulating  the 
IroodPog  class 


class  GoodDog  { 

private  int  size; 


public  int  getSizeO  { 


jLlfr 

iefctcf  B‘et* 


/• 


return  size; 


public  void  setSize (int  s)  { 
size  = s; 

) 


GoodDog 

size 


getSize( ) 
setSize( ) 
bark() 


Eve*  thoW'  d&r{>\  yfl 

add  ^ u ol  ^ 

* tiot  *»#  'TnL  a 

utor.  7<^  ***,  bat,kj?d 

„etM  s*Ccr,  bctier’ 


void  bark ( ) ( 

if  (size  > 60)  { 

System. out. println ("Wooof ! Wooof ! ") ; 
) else  if  (size  > 14)  { 

System. out. println ("Ruff!  Ruff ! ") ; 

} else  { 

System. out. println ("Yip ! Yip!") ; 


} 


Any  place  where  a 
particular  value  can 
be  used,  a method 
call  that  returns  that 
type  can  be  used, 

instead  of: 

fnt  x s 3 ♦ 24; 

you  can  say: 

int  x = 3 ♦ one.getSaeO: 


} 

) 

class  GoodDogTestDrive  { 

public  static  void  main  (Stringt)  args)  { 

GoodDog  one  = new  GoodDogO; 
one . setSize  (70) ; 

GoodDog  two  = new  GoodDogO; 
two. setSize  (8) ; 

System. out .println ("Dog  one:  " + one . getSi2e ( ) ) ; 
System. out .println ("Dog  two:  " + two . getSize ( ) ) ; 
one . bark ( ) ; 
two . bark  () ; 
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How  do  objects  in  an  array 
behave? 


like  any  other  object.  The  only  difference  is 
bow  you  get  to  them.  In  other  words,  how  you  get 
the  remote  control.  Lets  try  calling  methods  on 
Dog  objects  in  an  airay. 


Declare  and  create  a Dog  array, 
to  hold  7 Dog  references. 

Dog[]  pets; 


pets  = new  Dog [7]  * 


Dog[] 


bog  array  object  (bog[J) 


e 

o 
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Create  two  new  Dog  objects, 
and  assign  them  to  the  first 
two  array  elements. 

pets  [0]  = new  Dog  ()  ; 
pets[l]  = new  Dog(); 


Call  methods  on  the  two  Dog 
objects. 

pets [0] . setSize (30) ; 
int  x = pets[0]  . getSize()  ; 
pets  [1]  . setSize  (8)  ; 


Dog[3 


Dog  array  object  (Dog[J) 
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initializing  instance  variables 


Pedarlng  and  initializing 
instance  variables 

You  already  know  that  a variable  declaration  needs  at  least  a name 
and  a type: 

int  size; 

String  name; 

And  you  know  that  you  can  initialize  (assign  a value)  to  the 
variable  at  the  same  time: 

int  size  = 420; 

String  name  = "Donny" ; 

But  when  you  don’t  initialize  an  instance  variable,  what  happens 
when  you  call  a getter  method?  In  other  words,  what  is  the  value  of 
an  instance  variable  before  you  initialize  it? 


class  PoorDog  { 

private  int  size; 
private  String  name;^ 


fe.t  do*’t  a 


public  int  gatSizef) 

return  size;  / 

) 14 

public  String  getName  ( ) { 
return  name; 

) 


WViat  will  rcW?? 


Instance  variables 
always  get  a 
default  value.  If 
you  don’t  explicitly 
assign  a value 
to  an  instance 
variable,  or  you 
don’t  call  a setter 
method,  the 
instance  variable 
still  has  a value! 


integers  0 

floating  points  0.0 

booleans  false 

references  null 


) 


public  class  PoorDogTestDrive  { 

public  static  void  main  (String [1  args)  { 
PoorDog  one  = new  PoorDog (); 

System,  out .println ("Dog  size  is 
System. out. println("Dog  name  is 


) 


+ one . getSize ( ) 
+ one  , getName  ( ) 


} 


file  Edit  Window  Help  CalfVei 


1 


% java  PoorDogTestDrive 
Dog  size  is  0 
Dog  name  is  null 


, . i.  varieties: 

You  don’t  V,avc  to  ^ aufc 

beuwe  J j t 0j  boolean  yt 

J ..  . i ^ a vemo-U  control  tKat 

amwed  to  a^'"*  A 
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and  local  variables 
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A Instance  variables  are  declared 
inside  a class  but  not  within  a method. 

class  Horse  { 

private  double  height  = 15.2; 
private  String  breed; 

/ / more  code . . . 

} 


Local  variables  are  declared  within  ajnethod. 


class  AddThing  { 
int  a; 
int  b = 12; 


public  int  add()  { 
int  total  = a + b; 
return  total; 

) 

} 


Local  variables  MU5T  be  initialized  before  use! 


class  Foo  { 

public  void  go ( ) { 

int  X; 

int  z = x + 3; 


) 


} 


detbv-c  * '•"****  V? 
but  as  t<x»  * **7 

io  USfc  >t.  ^>e 

breaks  ou't 


| File  edit  Window  Help  vikeT 


% javac  Foo. java 

Foo. java: 4:  variable  x might 
not  have  been  initialized 

int  z = x + 3; 

1 error  A 


Local  variables  do 
NOT  get  a default 
value!  The  compiler 
complains  if  you 
try  to  use  a local 
variable  before 
the  variable  is 
initialized. 


C^nfl?1^ue.stic>ng 

0;  What  about  method  parameters? 
How  do  the  rules  about  local  variables 
apply  to  them? 

A. 

Method  parameters  are  virtually  the 
same  as  local  variables— they're  declared 
Inside  the  method  (well,  technically  they're 
declared  in  the  argument //sf  of  the  method 
rather  than  within  the  body  of  the  method, 
but  they're  still  local  variables  as  opposed  to 
instance  variables).  But  method  parameters 
will  never  be  uninitialized,  so  you'll  never  get 
a compiler  error  telling  you  that  a parameter 
variable  might  not  have  been  initialized. 

But  that's  because  the  compiler  will  give 
you  an  error  if  you  try  to  invoke  a method 
without  sending  arguments  that  the  method 
needs.  So  parameters  are  ALWAYS  initialized, 
because  the  compiler  guarantees  that 
methods  are  always  called  with  arguments 
that  match  the  parameters  declared  for  the 
method,  and  the  arguments  are  assigned 
(automatically)  to  the  parameters. 
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Comparing  variables  (primitives  or  references) 

Sometimes  you  want  to  know  if  two  primitives  are  the  same.  That's  easy 
enough  Just  use  the  = operator  Sometimes  you  want  to  know  if  two 
reference  variables  refer  to  a single  object  on  the  heap.  Easy  as  well  Just  use 
the  =-  operator.  But  sometimes  you  want  to  know  if  two  objects  are  equal. 

And  for  that,  you  need  the  . equals ()  method.  The  idea  of  equality  for 
objects  depends  on  the  type  of  object.  For  example,  if  two  different  String 
objects  have  the  same  characters  (say,  “expeditious'1),  they  are  meaningfully 
equivalent,  regardless  of  whether  they  are  two  distinct  objects  on  the  heap. 

But  what  about  a Dog?  Do  you  want  to  treat  two  Dogs  as  being  equal  if  they 
happen  to  have  the  same  size  and  weight?  Probably  not.  So  whether  two 
different  objects  should  be  treated  as  equal  depends  on  what  makes  sense  for 
that  particular  object  type.  We’U  explore  the  notion  of  object  equality  again 
in  later  chapters  (and  appendix  B),  but  for  now,  we  need  to  understand  that 
the  ==  operator  is  used  only  to  compare  the  bits  in  two  variables.  What  those 
bits  represent  doesn't  matter.  The  bits  are  either  the  same,  or  they're  not. 

To  compare  two  primitives,  use  the  ==  operator 


Use  ==  to  compare 
two  primitives, 
or  to  see  if  two 
references  refer  to 
the  same  object. 

Use  the  equals() 
method  to  see 
if  two  different 
objects  are  equal. 

(Such  as  two  different 
String  objects  that  both 
represent  the  characters 
in  “Fred") 


The  = operator  can  be  used  to  compare  two  variables  of  any  kind,  and  it 
simply  compares  the  bits. 

if  (a  = b)  {...}  looks  at  the  bits  in  a and  b and  returns  true  if  the  bit  pattern 


is  the  same  (although  it  doesn't  care  about  the  size  of  the  variable,  so  all  the 
extra  zeroes  on  the  left  end  don't  matter).  o*  - 


int  a = 3; 
by to  b = 3; 

if  (a  ==  b)  { //  true  ) 


<■***££ 


art 

A iYt . w* 

f ab** 


byte 


To  see  If  two  references  are  the  same  (which  means  they 
refer  to  the  same  object  on  the  heap)  use  the  ==  operator 


Remember,  the  ==  operator  cares  only  about  the  pattern  of  bits  in  the 
variable.  The  rules  are  the  same  whether  die  variable  is  a reference  or 
primitive.  So  the  ==  operator  returns  true  if  two  reference  variables  refer  to 
the  same  object!  In  that  case,  we  don't  know  what  the  bit  paitem  is  (because 
it's  dependent  on  the  JVM,  and  hidden  from  us)  but  we  do  know  that  whatever 
it  looks  like,  it  will  be  the  same  for  two  references  to  a single  object 

Foo  a = new  Foo()  ; 

Foo  b = new  Foo ( ) ; 

Foo  c = a; 


if  (a  ==  b)  { //  false  } 

if  (a  ==  a)  { //  true  } 

if  (b  ==  c)  ( //  false  } 


a t ii  true 

a b is  -false 
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MaUe  A 

Roses  are  red, 
this  poem  is  choPPV' 
passing  hy  value 
is  passing  by  copy- 

U «er?Tryit.RePtaceoUt 

— — 


What's  legal? 

Given  the  method  below,  which 
of  the  method  colls  listed  on  the 
right  ore  legal? 

Put  a checkmark  next  to  the 
ones  that  ore  legal.  (Some 
statements  are  there  to  assign 
values  used  in  the  method  calls). 


KEEP 

RIGHT 


int  a - calcArea(7,  12)  ; 

short  c = 7 ; 

calcArea (c , 15) ; 

int  d = calcArea (57 ) ; 

calcArea  (2 , 3)  ; 

long  t = 42; 

int  f = calcArea (t, 17) ; 


int  calcArea(int  height,  int  width)  { 
return  height  * width; 

) 


int  g = calcAraa(); 
calcArea  ( ) ; 

byte  h = calcArea(4/20)  ; 
int  j = calcArea  (2,3,5); 


you  are  here  ► 
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exercise:  Be  the  Compiler 


BE  compiler 

Each  of  the  Java  files  on  -fids  page 
represents  a complete  source  file. 
Your  job  is  to  play  compiler  and 
determine  whether  each  of  these  files 
will  compile.  If  they  won't 
compile,  how  would  you 
fix  ^kem,  and  if  they  do 
compile,  what  would  be 
their  output? 


A 

class  XCopy  { 

public  static  void  main(String  [)  args)  { 
int  orig  = 42; 

XCopy  x = new  xCopy(); 
int  y = x.go(orig) ; 

System. out. println( orig  + " " + y) ; 

} 

int  go (int  arg)  { 
arg  = arg  * 2; 
return  arg; 

> 

} 


B 

class  Clock  { 

String  time; 

void  setTime(String  t)  { 
time  = t; 

} 

void  getTime()  { 
return  time; 

} 

} 

class  ClockTestDrive  { 

public  static  void  main(String  (]  args)  { 

Clock  c = new  Clock) ); 

c .setTime( " 1245" ) ; 

String  tod  = c.getTimef ) ; 

System. out. print In {"time:  " + tod); 

} 
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A bunch  of  Java  components,  in  full  costume,  are  playing  a party 
game, "Who  am  I?'  They  give  you  a clue,  and  you  try  to  guess  who 
they  are,  based  on  what  they  say.  Assume  they  always  tell  the  truth 
about  themselves.  If  they  happen  to  say  something  that  could  be  true 
for  more  than  one  guy,  then  write  down  all  for  whom  that  sentence 
applies.  Fill  in  the  blanks  next  to  the  sentence  with  the  names  of  one 
or  more  attendees, 

Tonight's  attendees: 

Instance  variable,  argument  return,  getter,  setter, 
encapsulation,  public,  private,  pass  by  value,  method 


A class  can  have  any  number  of  these. 

A method  can  have  only  one  of  these. 

This  can  be  Implicitly  promoted. 

I prefer  my  Instance  variables  private. 

It  really  means  ‘make  a copy’. 

Only  setters  should  update  these. 

A method  can  have  many  of  these. 

I return  something  by  definition. 

I shouldn’t  be  used  with  instance  variables. 
I can  have  many  arguments. 

By  definition,  I take  one  argument. 

These  help  create  encapsulation. 

I always  fly  solo. 
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puzzle:  Mixed  Messages 


Mixed 

Messages 


A short  Java  program  is  listed  to  your  right. 
Two  blocks  of  the  program  are  missing. 
Vour  challenge  Is  to  match  the  candidate 
blocks  of  code  (below),  with  the  output 
that  you'd  see  if  the  blocks  were  Inserted. 

Not  all  the  lines  of  output  will  be  used,  and 
some  of  the  lines  of  output  might  be  used 
more  than  once.  Draw  lines  connecting 
the  candidate  blocks  of  code  with  their 
matching  command-line  output. 


Candidates:  Possible  output: 

14  7 

9 5 i 
19  1 
14  1 


20  5 


25  1 
7 7 
20  1 


x < 9 
index  < 5 

x < 20 
index  < 5 

x < 7 
index  < 7 

x < 19 
index  < l 
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p@@]  puzz]e 


Your  job  is  to  take  code  snippets  from  the 
pool  and  place  them  Into  the  blank  lines 
in  the  code.  You  may  not  use  the  same 
snippet  more  than  once,  and  you  won't 
need  to  use  all  the  snippets. Your  goat 
s to  make  a class  that  will  compile  and 
run  and  produce  the  output  listed. 


public  class  Puzzle4  { 

public  static  void  main(String  []  args)  { 


int  y = 1; 
int  x = 0; 
int  result  - 0; 
while  (x  < 6)  { 


y = y * 10; 


> 

x = 6; 

while  (x  > 0)  < 


Output 

|~F]le  Edit  Window  Help  BeltyFloi 


%java  Puzzle4 
result  543345 


result  = result  + 

> 

System. out. println( "result  " + result); 

> 

> 

class  { 

int  ivar; 

doStuff(int  ) { 

if  (ivar  > 100)  { 
return 
> else  { 


return 


Note:  Each  snippet 
from  the  pool  can  be 
used  only  once! 
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puzzle:  Five  Minute  Mystery 


Plse-Minufe 

Mystery 


Fast  Times  in  Stim-City 


When  Buchanan  jammed  his  twitch-gun  into  Jai’s  side,  Jai  froze.  Jai  knew  that  Buchanan 
was  as  stupid  as  he  was  ugly  and  he  didn’t  want  to  spook  the  big  guy.  Buchanan  ordered  Jai 
into  his  boss’s  office,  but  Jai’d  done  nothing  wrong,  (lately),  so  he  figured  a little  chat  with 
Buchanan’s  boss  Leveler  couldn’t  be  too  bad.  He’d  been  moving  lots  of  neural-summers  in 
the  west  side  lately  and  he  figured  Leveler  would  be  pleased.  Black  market  sti turners  weren’t 
the  best  money  pump  around,  but  they  were  pretty  harmless.  Most  of  the  s rim-junkies  he’d 
seen  tapped  out  after  a while  and  got  back  to  life,  maybe  just  a little  less  focused  than  before. 

Leveler’s  'office’  was  a skungy  looking  skimmer,  but  once  Buchanan  shoved  him  in,  Jai 
could  see  that  it’d  been  modified  to  provide  all  the  extra  speed  and  armor  that  a local  boss  like 
Leveler  could  hope  for.  "Jai  my  boy”,  hissed  Leveler,  "pleasure  to  see  you  again”.  "Likewise 
l*m  sure,..”,  said  Jai,  sensing  the  malice  behind  Leveler’s  greeting,  "We  should  be  square 
Leveler,  have  I missed  something?”  “Ha!  You’re  making  it  look  pretty  good  Jai,  your  volume 
is  up,  but  I’ve  been  experiencing,  shall  we  say,  a little  'breach’  lately...”  said  Leveler. 


Jai  winced  involuntarily,  he’d  been  a top  drawer  jack-hacker  in  his  day.  Anytime  someone 
figured  out  how  to  break  a street-jack’s  security,  unwanted  attention  turned  toward  Jai.  <fNo 
way  it’s  me  man”,  said  Jai,  "not  worth  the  downside.  I’m  retired  from  hacking,  I just  move 
my  stuff  and  mind  my  own  business”.  "Yeah,  yeah”,  laughed  Leveler,  "I’m  sure  you’re 
clean  on  this  one,  but  I’ll  be  losing  big  margins  until  this  new  jack-hacker  is  shut 
out!”  “Well,  best  of  luck  Leveler,  maybe  you  could  just  drop  me  here  and  I’U  go 
move  a few  more  'units’  for  you  before  I wrap  up  today”,  said  Jai. 


“I’m  afraid  it’s  not  that  easy  Jai,  Buchanan  here  tells  me  that  word  is  you’re 
current  on  J37NE”,  insinuated  Leveler.  “Neural  Edition?  sure  I play  around  a bit,  so 
what?”  Jai  responded  feeling  a little  queasy.  "Neural  edition’s  how  I let  the  stim-junkies 
know  where  the  next  drop  will  be”,  explained  Leveler.  'Trouble  is,  some  stim-junlde’s  stayed 
straight  long  enough  to  figure  out  how  to  hack  into  my  WareHousing  database.”  “I  need  a 
quick  thinker  like  yourself  Jai,  to  take  a look  at  my  StimDrop  J37NE  class;  methods,  instance 
variables,  the  whole  enchilada,  and  figure  out  how  they’re  getting  in.  It  should..”,  "HEY!”, 
exclaimed  Buchanan,  “I  don’t  want  no  scum  hacker  like  Jai  nosin’  around  my  code!”  "Easy 
big  guy”,  Jai  saw  his  chance,  “I’m  sure  you  did  a top  rate  job  with  your  access  modi..  "Don’t 
tell  me  - bit  twiddler!”,  shouted  Buchanan,  "I  left  all  of  those  junkie  level  methods  public, 
so  they  could  access  the  drop  site  data,  but  I marked  all  the  critical  WareHousing  methods 
private.  Nobody  on  the  outside  can  access  those  methods  buddy,  nobody!” 


"I  think  I can  spot  your  leak  Leveler,  what  say  we  drop  Buchanan  here  off  at  the  comer 
and  take  a cruise  around  the  block”,  suggested  Jai.  Buchanan  reached  for  his  twitch-gun  but 
Leveler’s  stunner  was  already  on  Buchanan’s  neck,  "Let  it  go  Buchanan”,  sneered  Leveler, 
"Drop  the  twitcher  and  step  outside,  I think  Jai  and  I have  some  plans  to  make”. 
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What  did  Jai  suspect? 

Will  he  get  out  of  Leveler’s  skimmer  with  all  his  bones  intact? 


methods  use  Instance  variables 


Exercise  Solutions 


class  Clock  { 

String  time; 

void  setTime( String  t)  { 
time  - t ; 

} 

String  getTime()  { 
return  time; 

> 

) 


Zsss  XCopy1  compiles  and  runs  as  it  stands  I The 
I 42  84'.  Remember  Java  is  pass  by  value,  (which 
fKS  by  copy),  the  variable  ‘orig’  is  not  changed  by  the 


class  ClockTestDrive  { 

public  static  void  main (String  []  args)  { 
Clock  c = new  Clock( ) ; 
c. setTime( "1245" ) ; 

String  tod  = c.getTime( ) ; 

System. out. println( "time:  " + tod); 


} 


Note:  'Setter'  methods  have  a return 
type  by  definition. 


Adass  can  have  any  number  of  these. 

A method  can  have  only  one  of  these. 

Ttvs  can  be  implicitly  promoted, 
f prefer  my  instance  variables  private, 
t really  means  'make  a copy1. 

Only  setters  should  update  these. 

A method  can  have  many  of  these, 
return  something  by  definition. 

: shouldn't  be  used  with  instance  variables 
can  have  many  arguments. 

By  definition,  I take  one  argument. 

These  help  create  encapsulation, 
always  fly  solo. 


Instance  variables,  getter,  setter, method 
return 

return,  argument 

encapsulation 

pass  by  value 

Instance  variables 

argument 

getter 

public 

method 

setter 

getter,  setter,  public,  private 
return 
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Puzzle  Solutions 


Answer  to  the  5-minute  mystery... 


public  class  Puzzle4  { 

public  static  void  main (String  []  args)  { 
Puzzls4b  [ ] obs  = new  Puzzle4b[6J; 
int  y “ 1; 
int  x - 0; 
int  result  = Oj 
while  (x  < 6)  { 

obs[x]  = new  Puzzle4b(  ): 
obs[x] . ivar  - y; 
y " y * 10? 
x = x ♦ 1: 

) 

x = 6j 

while  (x  > 0)  { 
x - x - 1; 

result  = result  + obs[x].doSTuff(x); 

> 

Systemroot *println( "result  " + result) ; 

> 

> 

class  Puzz!e4b  { 
int  ivar; 

public  int  doStuff(int  factor)  { 
if  (ivar  > 100)  { 
return  ivar  * factor; 

> else  { 

return  ivar  * (5  - factor); 

y Output 


ft  java  Puzzled 
result  543345 


Jai  knew  that  Buchanan  wasn’t  the  sharpest 
pencil  in  the  box.  When  Jai  heard  Buchanan 
talk  about  his  code,  Buchanan  never  mentioned 
his  instance  variables.  Jai  suspected  that 
while  Buchanan  did  in  fact  handle  his  methods 
correctly,  he  failed  to  mark  his  instance  variables 
private.  That  slip  up  could  have  easily  cost 
Leveler  thousands. 


Candidates:  Possible  output: 
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Extra-Strength  Methods 


Let’s  put  some  muscle  in  our  methods.  We  dabbled  with  variables,  played 

with  a few  objects,  and  wrote  a little  code.  8ut  we  were  weak.  We  need  more  tools.  Like 
operators.  We  need  more  operators  so  we  can  do  something  a little  more  interesting  than,  say, 
bark.  And  loops.  We  need  loops,  but  what's  with  the  wimpy  while  loops?  We  need  for  loops 
if  we're  really  serious.  Might  be  useful  to  generate  random  numbers.  And  turn  a String 
into  an  tnt,  yeah,  that  would  be  cool.  Better  learn  that  too.  And  why  don't  we  learn  It  all  by 
building  something  real,  to  see  what  it's  like  to  write  (and  test)  a program  from  scratch.  Maybe 
a game,  like  Battleships.That's  a heavy-lifting  task,  so  It'll  take  two  chapters  to  finish.  We'll  build 
a simple  version  in  this  chapter,  and  then  build  a more  powerful  deluxe  version  in  chapter  6. 
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building  a real  game 


Let's  build  a Pattleship-style 
game:  "Sink  a Pot  Com" 


It’s  you  against  the  computer,  but  unlike  the  real 
Battleship  game,  in  this  one  you  don't  place  any  ships 
of  your  own.  Instead,  your  job  is  to  sink  the  computer’s 
ships  in  the  fewest  number  of  guesses. 

Oh,  and  we  aren't  sinking  ships.  We're  killing  Dot 
Corns.  (Thus  establishing  business  relevancy  so  you  can 
expense  the  cost  of  this  book). 

Goal:  Sink  all  of  die  computer's  Dot  Corns  in  the  fewest 
number  of  guesses.  You're  given  a raring  or  level,  based 
on  how  well  you  perform. 

Setup:  When  the  game  program  is  launched,  the 
computer  places  three  Dot  Corns  on  a virtual  7x7 
grid.  When  that's  complete,  the  game  asks  for  your  first 
guess, 


How  you  play:  We  haven’t  learned  to  build  a GUI  yet,  so 
this  version  works  at  the  command-line.  The  computer 
will  prompt  you  to  enter  a guess  (a  cell),  that  you'll  type 
at  the  command-line  as  "AS”,  "C5”,  etc.).  In  response 
to  your  guess,  you'll  see  a result  at  the  command- 
line,  either  "Hit”,  "Miss”,  or  "You  sunk  Pets.com”  (or 
whatever  the  lucky  Dot  Com  of  the  day  is).  When 
you've  sent  all  three  Dot  Corns  to  that  big  404  in  the 


stairb  it  iero, 


like  Java  array* 


You’re  going  to  build  the 
Sink  a Dot  Com  game,  with 
a 7 x 7 grid  and  three 
Dot  Corns.  Each  Dot  Com 
takes  up  three  cells. 


part  of  a ga m interaction 


tile  Edit  Window  Halp  Sail  I 


% java 

DotComBust 

Enter 

a 

guess 

A3 

miss 

Enter 

a 

guess 

B2 

miss 

Enter 

a 

guess 

C4 

Imiss 

Enter 

a 

guess 

D2 

hit 

Enter 

a 

guess 

D3 

hit 

Enter 

a 

guess 

D4 

Ouch! 

You  sunk 

Pets . com 

: ( 

kill 

Enter 

a 

guess 

B4 

miss 

Enter 

a 

guess 

G3 

hit 

Enter 

a 

guess 

G4 

hit 

Enter 

a 

guess 

G5 

Ouch! 

You  sunk 

AskMe . com 

: ( 
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writing  a program 


First,  a high-level  design 

We  know  we’U  need  classes  and  methods,  but  what 
should  they  be?  To  answer  that,  we  need  more 
information  about  what  the  game  should  do. 

Fust,  we  need  to  figure  out  the  general  flow  of  the 
pjne.  Here’s  the  basic  idea; 


User  starts  the  game 

Seme  creates  three  Dot  Corns 

Game  places  the  three  boi 
Corns  onto  a virtual  grid 


1^1  Same  play  begins 

Repeat  the  following  until  there  are 
no  more  Dot  Corns: 


C 


o 

o 


Prompt  user  for  a guess 
(“A 2",  *C0",  etc.) 


Check  the  user  guess  against 
all  Dot  Corns  to  look  for  a hit, 
miss,  or  kill.  Take  appropri- 
ate action:  if  a hit,  delete  cell 
(A2,  D4,  etc.).  If  a kill,  delete 
Dot  Com. 


Game  finishes 

Give  the  user  a rating  based  on 
the  number  of  guesses. 


Now  we  have  an  idea  of  the  kinds  of  things  the 
program  needs  to  do.  The  next  step  is  figuring 
out  what  kind  of  objects  we‘il  need  to  do  the 
work.  Remember,  think  like  Brad  rather  than 
Larry;  focus  first  on  the  things  in  the  program 
rather  than  the  procedures. 


Whoa.  Areal  flow  chart. 
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a simpler  version  of  the  game 


the  "Simple  Pot  Com  Came" 

a gentler  introduction 

It  looks  like  we're  gonna  need  at  least  two  classes,  a 
Game  class  and  a DotCom  class.  But  before  we  build 
the  full  monty  Sink  a Dot  Com  game,  we'll  start  with 
a stripped<lown,  simplified  version,  Simple  Dot  Com 
Game.  We’ll  build  the  simple  version  in  this  chapter, 
followed  by  the  deluxe  version  that  we  build  in  the 
next  chapter. 

Everything  is  simpler  in  this  game.  Instead  of  a 2-D 
grid,  we  hide  the  Dot  Com  in  just  a single  row.  And 
instead  of  three  Dot  Corns,  we  use  one 


OGame  starts,  and  creates  ONE  DotCom 
and  gives  it  a location  on  three  cells  in 
the  single  row  of  seven  cells. 

Instead  of  "A2\  Y4",  and  so  on,  the 
locations  are  just  integers  (far  example: 
1,2,3  are  the  cell  locations  in  this 
pictures 


0 12  3 4 5 6 


The  goal  is  the  same,  though,  so  the  game  still  needs 
to  make  a DotCom  instance,  assign  it  a location 
somewhere  in  the  row,  get  user  input,  and  when  all 
of  the  DotCom’s  cells  have  been  hit,  the  game  is  over. 
This  simplified  version  of  the 
game  gives  us  a big  head  start 
on  building  the  full  game. 

If  we  can  get  this  small  one 
working,  we  can  scale  it  up  to 
the  more  complex  one  later 

In  this  simple  version,  the 
game  class  has  no  instance 
variables,  and  all  the  game 
code  is  in  the  main()  method. 

In  other  words,  when  the 
program  is  launched  and 
main()  begins  to  run,  it  will 
make  the  one  and  only  DotCom 
instance,  pick  a location  for  it  (three 
consecutive  cells  on  the  single  virtual 
seven-cell  row),  ask  the  user  for  a guess,  check  the 
guess,  and  repeat  until  all  three  cells  have  been  hit. 


e 


Keep  in  mind  that  the  virtual  row  is...  virtual  In  other 
words,  it  doesn’t  exist  anywhere  in  the  program.  As 
long  as  both  the  game  and  the  user  know  that  the 
DotCom  is  hidden  in  three  consecutive  cells  out  of  a 
possible  seven  (starting  at  zero),  the  row  itself  doesn't 
have  to  be  represented  in  code.  You  might  be  tempted 
to  build  an  array  of  seven  ints  and  then  assign  the 
DotCom  to  three  of  the  seven  elements  in  the  array, 
but  you  don't  need  to.  All  we  need  is  an  array  that 
holds  just  the  three  cells  the  DotCom  occupies. 


Game  play  begins.  Prompt  user  for 
a guess,  then  check  to  see  if  it  hit 
any  of  the  DotCom's  three  cel/s. 

If  a hit,  increment  the  numOfHits 
variable. 

Game  finishes  when  all  three  cells  have 
been  hit  (the  numOf  Hits  variable  val- 
ue is  3),  and  tells  the  user  how  many 
guesses  it  took  to  sink  the  bottom. 


A complete  game  Interaction 

Help  Ofcsiiov  ~l 


%java  SimpleDotComGame 
enter  a number  2 
hit 

enter  a number  3 
hit 

enter  a number  4 
miss 

enter  a number  1 
kill 

You  took  4 guesses 
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writing  a program 


developing  a Class 

As  a programmer,  you  probably  have  a methodology/ 
rrocess/approach  to  writing  code.  Well,  so  do  we.  Our 
sequence  is  designed  to  help  you  see  (and  learn)  what 
we  Ye  thinking  as  we  work  through  coding  a class.  It 
isnt  necessarily  the  way  we  (or  you)  write  code  in  the 
Real  World.  In  the  Real  World,  of  course,  you'll  follow 
die  approach  your  personal  preferences,  project,  or 
employer  dictate.  We,  however,  can  do  pretty  much 
whatever  we  want  And  when  we  create  a Java  class  as  a 
Teaming  experience”,  we  usually  do  it  like  this: 

O Figure  out  what  the  class  is  supposed  to  do. 

□ List  the  instance  variables  and  methods. 

□ Write  prepcode  for  the  methods.  (You'll  see 
this  in  just  a moment) 


The  three  things  well  write  for 
each  class: 


prepcode  test  code 


real  code 


This  bar  is  displayed  on  the  next  set  of  pages  to  telf 
you  which  part  you're  working  on.  For  example,  if  you 
see  this  picture  at  the  top  of  a page,  it  means  you're 
working  on  prepcode  for  the  SimpleDotCom  class. 


SimpleDotCom  class 

prop  coda  ■fatcode 


real  code 


prep  code 

A form  of  pseudocode,  to  help  you  focus  on 
the  logic  without  stressing  about  syntax. 


O Write  test  code  for  the  methods. 

□ Implement  the  class. 

□ Test  the  methods. 

□ Debug  and  reimplement  as  needed. 

□ Express  gratitude  that  we  don't  have  to  test 
our  so-called  learning  experience  app  on 
actual  live  users. 


test  code 

A class  or  methods  that  will  test  the  real  code 
and  validate  that  it’s  doing  the  right  thing. 


Bex  those  dendrites. 

How  would  you  decide  which  class  or  classes 
to  build  first,  when  you're  writing  a program? 
Assuming  that  all  but  the  tiniest  programs 
need  more  than  one  class  {If  you're  following 
good  OO  principles  and  not  having  one  class 
do  many  different  Jobs),  where  do  you  start? 


SimpleDotCom  ci« 

□ write  prep  code 

□ write  teat  code 

O write  final  Jave  code 

(OrtComGome 


Simple1 
class 

□ write  prep 
write  test 
□ write  final 


code 
code  inol 
i Java  code 


real  code 

The  actual  implementation  of  the  class.  This  is 
sal  Java  code. 
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SimpleOotCom  class 


prep  coda 


real  code 


SfmpleDotCom 
irrt  0 taatiwiCells 
ini  numOJHite 

String  checkYoursetfl  String  guess) 
void  selocalionCelbfinlO  lx) 


YouTl  get  the  idea  of  how  prepcode  (our  version  of  pseudocode)  works  as  you 
read  through  this  example.  It*s  sort  of  half-way  between  real  Java  code  and  a plain 
English  description  of  the  class.  Most  prepcode  includes  three  parts:  instance 
variable  declarations,  method  declarations,  method  logic.  The  most  important 
part  of  prepcode  is  the  method  logic,  because  it  defines  what  has  to  happen, 
which  we  later  translate  into  haw,  when  we  actually  write  the  method  code. 

DECLARE  an  int  array  to  hold  the  location  cells.  Call  it  /ocatfonCe//$. 

DECLARE  an  int  to  hold  the  number  of  hits.  Call  rt  numOfH'ns  and  SET  it  to  0. 


DECLARE  a checkYourselfQ  method  that  takes  a String  for  the  users  guess  ('TV'3".  etc.), 
checks  it  and  returns  a result  representing  a "hit",  "miss",  or  "kill". 


DECLARE  a setiocat/oriCeWsQ  setter  method  that  takes  an  ;nt  array  (which  has  the  three  cell 
locations  as  ints  (X3A  etc.). 


METHOD:  String  check Yourseff(String  userGuess) 

GET  the  user  guess  as  a String  parameter 
CONVERT  the  user  guess  to  an  int 

I REPEAT  with  each  of  the  location  cells  in  the  int  array 

//  COMPARE  the  user  guess  to  the  location  cell 

I IF  the  user  guess  matches 

INCREMENT  the  number  of  hits 
//FIND  OUT  rf  it  was  the  last  location  cell: 

IF  number  of  hits  is  3,  RETORN  "kill"  as  the  result 
ELSE  rt  was  not  a kill,  so  RETURN’Tirt" 

END  IF 

ELSE  the  user  guess  did  not  match,  so  RETURN  "miss" 
END  IF 
END  REPEAT 
END  METHOD 


n 


METHOD:  void  setLocationCe//s(/ntfJ  cellLocatJons) 

GET  the  cell  locations  as  an  ini  array  parameter 

ASSIGN  the  cell  locations  parameter  to  the  cell  locations  instance  variable 
END  METHOD 
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Writing  the  method 
implementations 

let's  write  the  real 
method  code  now,  and  get 
this  puppy  working. 

Before  we  s tart  coding  the 
methods,  though,  let's  back 
up  and  write  some  code  to 
writhe  methods.  That's  right, 
we're  writing  the  test  code 
before  there's  anything  to  testl 

The  concept  of  writing 
the  test  code  first  is  one  of 
the  practices  of  Extreme 
Programming  (XP),  and 
it  can  make  it  easier  (and 
faster)  for  you  to  write  your 
code.  WeTe  not  necessarily 
saying  you  should  use  XP, 
but  we  do  like  the  part  about 
writing  tests  first.  And  XPjust 
sounds  cool. 


Oh  my!  For  a minute  j 
there  I thought  you 
weren't  gonna  write  your 
test  code  first.  Whoo! 
Don't  scare  me  like  that 


Extreme  Programming  (XP) 

extreme  Programming(XP)  is  a newcomer  to  the  software  Don't  put  in  anything  that's  not  in  the  spec  (no  matter 
development  methodology  world.  Considered  by  many  how  tempted  you  are  to  put  in  functionality"for  the 
to  be'the  way  programmers  really  want  to  work^XP  future"). 

I emerged  In  the  late  90's  and  has  been  adopted  by  Write  the  test  code  first, 

I companies  ranging  from  the  two-person  garage  shop 
:o  the  Ford  Motor  Company.The  thrust  of  XP  Is  that  the  No  killer  schedules;  work  regular  hours. 

I customer  gets  what  he  wants,  when  he  wants  It,  even  Refactor  (improve  the  code)  whenever  and  wherever  you 

I when  the  spec  changes  late  In  the  game.  notice  the  opportunity. 

XP  is  based  on  a set  of  proven  practices  that  are  all  Don't  re|ease  anything  until  It  passes  all  the  tests, 

designed  to  work  together, although  many  folks  do  pick 

and  choose, and  adopt  only  a portion  of  XP's  rules. These  Set  rea,lstic  schedules,  based  around  small  releases. 

I practices  include  things  like:  Keep  it  simple. 

I Make  small,  but  frequent,  releases.  Program  in  pairs,  and  move  people  around  so  that 

I Develop  in  Iteration  cycles.  everybody  knows  pretty  much  everything  about  the  code. 
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SimpleDotCom  class 


prep  cod®  toot  code 


real  code 


Writing  test  code  for  the  SfmplePotCoM  class 

We  need  to  write  test  code  that  can  make  a SimpleDotCom  object 
and  run  its  methods.  For  the  SimpleDotCom  class,  we  really 
care  about  only  the  checkYourselft)  method,  although  we  will  have 
to  implement  the  setLocationCells()  method  in  order  to  get  the 
checkYourselJO  method  to  run  correctly. 

Take  a good  look  at  the  prepcode  below  for  the  ckeckYoursdJ() 
method  {the  setLocatumCellsQ  method  is  a no-brainer  setter  method, 
so  we’re  not  worried  about  it,  but  in  a ‘real1  application  we  might 
want  a more  robust  ‘setter’  method,  which  we  woiUdwant  to  test). 

Then  ask  yourself,  “If  the  checkYourselfQ  method  were 
implemented,  what  test  code  could  I write  that  would  prove  to  me 
the  method  is  working  correctly?” 


Based  on  this  prepcode: 


Here's  what  we  should  test: 


METHOD  String  check Yourse/ffString  userCuess) 

GET  the  user  guess  as  a String  parameter 
CONVERT  the  user  guess  to  an  Int 
REPEAT  with  each  of  the  location  ceils  in  the  int  array 
//  COA^P4RE  the  user  guess  to  the  location  cell 
IF  the  user  guess  matches 

INCREMENT  the  number  of  hits 
//  FIND  OUT  if  it  was  the  last  location  cell: 

IF  number  of  hits  is  3.  RETURN  "Kill"  as  the  result 
ELSE  it  was  not  a kill  so  RETURN'W 
END  !F 

ELSE  the  user  guess  did  not  match,  so  RETURN  "Miss” 
END  IF 
END  REPEAT 
END  METHOD 


1 . Instantiate  a SimpleDotCom  object. 

2.  Assign  it  a location  (an  array  of  3 ints,  like 
{2,3,4}). 

3.  Create  a String  to  represent  a user  guess 
("2",  "0*.  etc.). 

4.  Invoke  the  checkYourself()  method  pass- 
ing it  the  fake  user  guess. 

5.  Print  out  the  result  to  see  if  It's  correct 
(“passed’’  or  “failed”), 
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Test  code  for  the  SimpIePotCom  class 


Maybe  I'm  missing  some- 
Atog  here,  but  how  exactly  do 
jam  run  a test  on  something 
mmt  doesn't  yet  exlstl? 


You  don't.  We  never  said 
•oj  start  by  running  the  test; 
fou  start  by  writing  the  test.  At 
Time  you  write  the  test  code, 
tou  won't  have  anything  to  run 
c against  so  you  probably  won't 
d© able  to  compile  It  until  you 
«*e 'stub' code  that  can  com- 
^e  but  that  will  always  cause 
retest  to  fail  (like,  return  null.) 

Oj  Then  I still  don't  see  the 
point.  Why  not  wait  until  the 
code  Is  written,  and  then  whip 
mm  the  test  code? 


I ^V*The  act  of  thinking  through 
and  writing)  the  test  code  helps 
darify  your  thoughts  about  what 
•r*  method  Itself  needs  to  do. 

soon  as  your  implementation 
rDGe  rs  done, you  already  have 
*5:  code  Just  waiting  to  validate 
«.  Besides,  you  know  If  you  don't 
oo  ! now,  you'll  never  do  It. 
here's  always  something  more 
meresting  to  do. 

Ideally,  write  a little  test  code, 
write  only  the  Implementa- 
aon  code  you  need  in  order  to 
sass  that  test. Then  write  a little 
*-*ye  test  code  and  write  only 
■re  new  implementation  code 
-^eded  to  pass  that  new  test.  At 
each  test  iteration,  you  run  all 
— e previously-written  tests,  so 
■rat  you  always  prove  that  your 
arest  code  additions  don't  break 
devious  I y-tested  code. 


public  class  Sia^leDotComTestDrive  { , ^ a 

public  static  void  main  (String  []  args)  { JoyjtJt 
SimplaDotCom  dot  = new  SimpleDotCom  ( ) ; ^ 

^ tt  ^ 

int[]  locations  = {2,3,4};  a 


CP* 


dot. setLocationCells (locations) ; 


String  usarGuess  = "2"; 


nJt-C  i 
user 


***«  ike 


String  result  = dot . checkYour self (userGuess) ; 

rc 

String  testRasult  = "failed"; 

a*d  >i  tK< 

TdXc 


if  (result. equals ("hit")  ) ( 
testRasult  * "passed"; 


> 


K-  ' vf  ^ (1) 

batk  a "W.r,  si* 


System. out. println (testResult) ; 


<s 


‘pa«ed  or  -failed”) 


) 

— ^ttarpen  your  pencil 

In  the  next  couple  of  pages  we  implement  the  SimpleDotCom  class, 
and  then  later  we  return  to  the  test  class.  Looking  at  our  test  code 
above,  what  else  should  be  added?  What  are  we  not  testing  in  this 
code,  that  we  should  be  testing  for?  Write  your  ideas  (or  lines  of 
code)  below: 


you  are  here  > 103 


SimpleDotCom  class 


real  code 


The  cheekYourselfl)  method 

There  isn’t  a perfect  mapping  from  prepcode  to  javacode;  you’ll  see  a few 
adjustments.  The  prepcode  gave  us  a much  better  idea  of  what  the  code  needs  to 
do,  and  now  we  have  to  find  the  Java  code  that  can  do  the  how . 

In  the  back  of  your  mind,  be  thinking  about  parts  of  this  code  you  might  want 
(or  need)  to  improve.  The  numbers  are  for  things  (syntax  and  language 
features)  you  haven’t  seen  yet.  They’re  explained  on  the  opposite  page. 


GET  the  user 
guess 

CONVERT 

the  user  guess  to 
an  int 


REPEAT  with 
each  ceil  in  the  int 
array 

IF  the  user  guess 
matches 


INCREMENT 

the  number  of 
hits 


public  String  checkYourself (String  stringGuess)  { 

£<mvert  the 

int  guess  = Integer  .par selnt  (stringGuess)  ; ^ ^ io  an  mi  9 

String  unit  - "mi..";  t ‘ WiaUe  U h0|d  ,,  , 

,‘t  Assume  a \\ss*) 


for  (int  cell  : locationCells)  { 
if  (guess  = cell)  { 
result  = "hit"; 

in 

numOfHits++ ; , 


ele»*» i (tell)  ih  1? ^ *°  ihis 
h wt  array 

we  3<»t  a Kit/ 


wiih  c..i  .. 


break; 

to  iesi  iL  i,  0°P'  "°  *ted 
U t ***  otKor  tells 


} //  end  if 


//  FtND  OUT  if 

it  was  the  last  cell 

IF  number  of  hits 
is  3, 

RETURN  111 

as  the  result 


ELSE  it  was 
not  a kill,  so 

RETURN  hit 


ELSE 

RETURN 

"miss'’ 


} //  and  for 

if  (numOfHits 


locationCells . length)  { 


result  = "kill"; 

} //  end  if 

System. out. println (result)  ; 


°f  ttt  H1.  w let';  ««  it  . 
"~,i  ot  W 5 ^ *d 

+***&  Striw)  &>  Yil I" 


were 


— display  -fchc  result  -for  the  user 
return  result;  ryV,iss"'  Uhless w*  iKa^ed  to  “Hit"  or  W) 

^ result  batk  to 

) //  end  method  the  tailing  method 
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Jistthe  new  stuff 

things  we  haven't  seen  before 
:m  this  page.  Stop  worrying!  The 
of  the  details  are  at  the  end  of 
:hapter.  This  isjust  enough  to  let 
keep  going. 


* ■ vv  Oawa- 


A mttod  in  tk< 

Integer  daw  that 

knows  kow  to  tKydnt}l 
A ijvto  Ike  mt 

it  reprtienti 


Converting  a 
String  to  an  int 


Integer.parselnt  (“3”) 


© The  for  loop 


Read  to  U loof*  d^arato  * ^Tat  to  ^ 0) 

to*  <aiVi  element i*  to  lota  twCcll*  wK„/c  i,.  "'eans  \u  . 

arriv  take  the  "«*t  element j*»  to,3,^  value  tN  lLT*’*  ^ Mdh  ' I 

JJLs*  * to  to  *t  variable  cell  • ^ ^ *i 

for  loop  for  (jnt  cell : locationCells)  { } 

?“'Tk  ' Va"i<>b,‘  ^ witl  Ho)d^  etoto  ^ -^,ate 

W to  away.  Eadh  toe  tooueh  ^ , -p*  to  ^ 

ikis  variable  fiw  J-l:.  . . , 3 . ^ ^ V«*e  ^ be  3 £ . ^ 

, a ,.m  rtn  "th' 


^e  a variable  to*  wit]  Udie 

t,  to  away.  Eadh  toe  toou.h  ^ , 

'this  variable  ft*  <f-k‘<  " '°^P> 

"d?m  ll  L (J  ™ ff*  ah  v3H3b,«  named 

£ei'  }*  VJl11  Wd  a di-PW-t  elemeni  ^ u “ 
arvay  until  thwc  are  no  mow  element  (*.  &e 
code  does  a V«k-..  see  beU) 


tdTto^ 


®The  post- increment 
operator 


numOfHits++ 


0 break  statement 


break; 


^Tkc  ++  tr^ani  add  I bo 
wkabvei/s  {}^Ye  Orv  other 
wca-ds*  increment  by  ))■ 

nUir>  0-PKits++  U tkc  s Ant  (\r\ 
this  dase)  as  saymj  numOttfit* : 

T\Vrr  0-fltts  + I,  c^£eft  slightly 

•more  £-p>fi£itfnt 


you  out  o-f  a loop,  Immediately.  Rijb-t  kev-e- 
Uo  iteration,  rvo  boolean  test  i***t  aA  out  *owf 
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Q/  What  happens  In 
Integer.parselntO  If  the  thing  you 
pass  Isn't  a number?  And  does  It 
recognize  spelled-out  numbers, 

I Ike  "three"? 


A* 

Jr\ - Integer.parselntO  works  only 
on  Strings  that  represent  the  ascii 
values  for  digits  (0,1, 2,3,4, 5,6, 7A9). 
If  you  try  to  parse  something  like 
"two'^r^blurp^the  code  will  blow 
up  at  runtime.  (By  blow  up,  we 
actually  mean  throw  on  exception , 
but  we  don't  talk  about  exceptions 
until  the  Exceptions  chapter.  So  for 
now, blowup  is  close  enough.) 


Q/ln  the  beginning  of  the 
book,  there  was  an  example  of  a 
for  loop  that  was  really  different 
from  this  one — are  there  two 
different  styles  of  for  loops? 


Yesl  From  the  first  version  of 
Java  there  has  been  a single  kind 
of  for  loop  (explained  later  In  this 
chapter)  that  looks  like  this; 

for  (Int  i = 0;  i < 10;  I++)  { 

//  do  something  10  times 

} 

You  can  use  this  format  for  any 
kind  of  loop  you  need.  But*., 
beginning  with  Java  5.0  (Tiger), 
you  can  also  use  the  enhanced  for 
loop  (that's  the  official  description) 
when  your  loop  needs  to  iterate 
over  the  elements  in  an  array  (or 
another  kind  of  collection,  as  you'll 
see  in  the  next  chapter).  You  can 
always  use  the  plain  old  for  loop 
to  iterate  over  an  array,  but  the 
enhanced  for  loop  makes  it  easier. 


Final  code  for  SimpkPotCom  and  SimplePotCowTester 

public  class  SimpleDotComTostDriv®  { 

public  static  void  main  (String!]  args)  { 
SimpleDotCom  dot  - new  SimpleDotCom (> ; 
int(]  locations  - (2,3,4); 
dot . setLocationCells (locations) ; 

String  userGu ess  = "2"; 

String  result  = dot . checkYourself (userGuess) ; 

> 

) 


public  class  SimpleDotCom  { 

int [ ] locationCells; 
int  numOfHits  = 0; 

public  void  setLocationCells (int ( ] Iocs)  ( 
locationCells  = Iocs; 

) 

public  String  checkYourself (String  stringGuess)  { 
int  guess  = Integer .parselnt (stringGuess) ; 
String  result  - "miss"; 
for  (int  cell  : locationCells)  { 
if  (guess  ==  cell)  { 
result  = "hit"; 
numOfHits++; 
break; 

) 

) //  out  of  the  loop 

if  (numOfHits  == 

locationCells . length)  ( 
result  = "kill"; 

) 

System. out .print In (result) ; 
return  result; 

) fi  close  method 
) //  close 


There’s  a little  bug  lurking  here.  It  compiles  end 
runs,  but  sometimes...  don't  worry  about  It  for  now, 
but  we  wltf  have  to  face  it  a little  later. 


What  should  we  see 
when  we  run  this  code? 

The  test  code  makes  a 
SimpleDotCom  object 
and  gives  it  a location  at 
2,3,4.Then  it  sends  a fake 
user  guess  of  into  the 
checkYouself()  method. 

If  the  code  is  working 
correctly,  we  should  see  the 
result  print  out: 


j a va  Si mp l e Do tComTe s t Dr i ve 
hit 
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cods  Mast  code 


real  code 


f^Jharpen  your  pencil 


We  built  the  test  class,  and  the  SimpleDotCom  class.  But  we  still  haven't 
made  the  actual  game.  Given  the  code  on  the  opposite  page,  and  the  spec  for 
the  actual  game,  write  in  your  ideas  for  prepcode  for  the  game  class.  We've  given 
you  a few  lines  here  and  there  to  get  you  started.  The  actual  game  code  is  on  the 
next  page,  so  don't  turn  the  page  unfit  you  do  this  exercise! 

You  should  have  somewhere  between  1 2 and  1 8 lines  (including  the  ones  we  wrote, 
but  not  including  lines  that  have  only  a curly  brace). 

METHOD  public  static  void  main  (String  Q orgs) 

DECLARE  an  int  variable  to  hold  the  number  of  user  guesses,  named  numO/Cuesses 


COMPUTE  a random  number  between  0 and  4 that  will  be  the  starting  location  cell  position 


The  SlmpleDotComGame 
needs  to  do  this: 

1. Make  the  single 
SimpleDotCom  Object. 

2.  Make  a location  for  It  (three 
consecutive  cells  on  a single 
row  of  seven  virtual  cells). 

3.  Ask  the  user  for  a guess. 

4.  Check  the  guess. 

5.  Repeat  until  the  dot  com  is 
dead  . 

6.  Tell  the  user  how  many 
guesses  it  took. 


A complete  game  Interaction 


WHILE  the  dot  com  is  still  alive  : 

GET  user  input  from  the  command  line 


%java  SimpleDotCoraGame 
enter  a number  2 
hit 

enter  a number  3 
hit 

enter  a number  4 
miss 

enter  a number  1 
kill 

You  took  4 guesses 


SimpleDotCom  class 


Prepcode  for  the  SimplePotComtame  class 

Everything  happens  In  main!) 

There  are  some  things  you'll  have  to  take  on  faith.  For  example,  we  have  one 
line  of  prepcode  that  says,  "GET  user  input  from  command-line”.  Let  me  tell 
you,  that’s  a little  more  than  we  want  to  implement  from  scratch  right  now.  But 
happily,  we’re  using  OO.  And  that  means  you  get  to  ask  some  other  class/ object 
to  do  something  for  you,  without  worrying  about  how  it  does  it.  When  you  write 
prepcode,  you  should  assume  that  somehow  you’ll  be  able  to  do  whatever  you 
need  to  do,  so  you  can  put  all  your  brainpower  into  working  out  the  logic. 


public  static  void  main  (String  £/  args) 

DECLARE  an  int  variable  to  hold  the  number  of  user  guesses,  named  numO/Guesses.  set  rt  to  0. 
MAKE  a new  SimpleDotCom  instance 

COMPUTE  a random  number  between  0 and  4 that  will  be  the  starting  location  cell  position 

MAKE  an  int  array  with  3 into  using  the  randomly-generated  number,  that  number  incremented  by  I, 
and  that  number  incremented  by  2 (example:  3.4.5) 

INVOKE  the  settocoaonCef/sQ  method  on  the  SimpleDotCom  instance 

DECLARE  a boolean  variable  representing  the  state  of  the  game,  named  isAWe.  SET  rt  to  true 


WHILE  the  dot  com  is  still  alive  (isAfive  ==  true) : 

GET  user  input  from  the  command  line 
//  CHECK  the  user  guess 

INVOKE  the  check YourselfO  method  on  the  SimpleDotCom  instance 
INCREMENT  numOfGuesses  variable 
//  CHECK  for  dot  com  death 


IF  result  is  "kill" 


SET  isA/ive  to  false  (which  means  we  won't  enter  the  loop  again) 


PRINT  the  number  of  user  guesses 


END  IF 
END  WHILE 
END  METHOD 


metacogtutive  iff 

Don't  work  one  part  of  the  brain  for  too  long  a stretch  at  one  time. 
Working  just  the  left  side  of  the  brain  for  more  than  30  minutes 
is  like  working  just  your  left  arm  for  30  minutes.  Give  each  side 
of  your  brain  a break  by  switching  sides  at  regular  intervals.  ‘ 
When  you  shift  to  one  side,  the  other  side  gets  to  rest  and 
recover.  Left-brain  activities  Include  things  like  step-by-step 
sequences,  logical  problem-solving,  and  analysis,  while  the 
right-brain  kicks  in  for  metaphors,  creative  problem-solving, 
pattern-matching,  and  visualizing. 
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BULLET  POINTS 


Your  Java  program  should  start  with  a high- 
level  design. 

Typically  you'll  write  three  things  when  you 
create  a new  class: 

prep  code 
teste ode 
real  (Java)  code 

Prepcode  should  describe  what  to  do,  not  how 
to  do  it.  Implementation  comes  later. 

Use  the  prepcode  to  help  design  the  test 
code. 

Write  test  code  before  you  implement  the 
methods. 


Choose  for  loops  over  while  loops  when  you 
know  how  many  times  you  want  to  repeat  the 
loop  code. 

Use  the  pre/post  increment  operator  to  add  1 
to  a variable  (x++;) 

Use  the  pre/post  decrement  to  subtract  1 from 
a variable  (x-;) 

Use  Integer. parselntf)  togettheint 
value  of  a String. 

Integer.  parselnt()  works  only  if  the 
String  represents  a digit  (“0r,T,"2n,  etc.) 

Use  break  to  leave  a loop  early  (i.e.  even  if 
the  boolean  test  condition  is  still  true). 
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SimpleDotComGame  class 


prep  code  test  code 


The  game's  mainl)  method 


Just  as  you  did  with  the  SimpleDotCom  class,  be  thinking  about  parts  of  this  code 
you  might  want  (or  need)  to  improve.  The  numbered  things  £ are  for  stuff  we 
want  to  point  out-  They*  re  explained  on  the  opposite  page.  Oh,  if  you’re  wonder- 
ing why  we  skipped  the  test  code  phase  for  this  class,  we  don’t  need  a test  class  for 
the  game.  It  has  only  one  method,  so  what  would  you  do  in  your  test  code?  Make 
a separate  class  that  would  call  mainQ  on  this  class?  We  didn’t  bother. 


DECLARE  a vari- 
able to  hold  user 
guess  count,  set  it 
to  0 


MAKE  a SimpleDot- 
Com object 

COMPUTE  a 

random  number 
between  0 and  A 

MAKE  an  im  army 
with  the  3 cell  loca- 
tions. and 

INVOKE  setLoca- 
tionCeils  on  the  dot 
com  object 

DECLARE  a bool 
ean  isAlive 

WHILE  the  dot 
com  is  still  alive 

GET  user  inpLft 

//  CHECK  it 

INVOKE  checkVo 
urselfQ  on  dot  com 

INCREMENT 

numOfGuesses 

IF  result  is '‘kill" 

SET  gameAlive  to 
false 

PRINT  the  number 
of  user  guesses 


public  static  void  main  (String  []  args)  ( to 

< — y®***  ^ 


int  nuznOf Guesses  = 0; 


GameHelper  helper  = new  GameHelper  ()  ; 


- — - 'this  is  a sy*£ial  l\ ass  w t woke  that  has 
th«  method  for  getting  4 iStr  input  (or 
now,  pretend  its  part  of  Java 

SimpleDotCom  theDotCom  = new  SimpleDotCom  0 ; < ±hc  doi 

# 

int  randomNum  = (int)  (Math . random ( ) * 5)  *&£  a random  number  for  the  first 

Ui\,  3nd  UK  i-t  ^ g £e|| 

~ Alrrdy 

( randomMum  , randomNum+1 , randomNum+2 ) ; 


int[]  locations 
theDotCom, setLocationCells (locations) ; 
boolean  isAlive  = true; 


^ dot  it*  ^ ***1* 


make  a boolean  variable  to  track  whether  the  game 
is  still  alive,  to  use  in  the  while  loop  test  repeat 
while  game  is  still  alive- 


^user 


t Str ^ 


while  (isAlive  = true)  ( 

String  guess  = helper .getUser Input (" enter  a number") ;< 

9tring  result  = theDotCom.  ahedkYour self  (guess)  ; ask  the  d*4-  > 

^thc  gwr« 

nwnOfGu«as«s++ ; ^ ih ^ ^ v«uj?  *i<*T*d 


if  (r«sult . equals  ("kill") ) ^ ^ . . 

r f ^ *•  **« <» « wt 

rt~e*ter  loop)  fmr.-t  «<*•  u*ni  -n 

s + " guesses")  ; 


isAlive  = false;  < 

System,  out. prin tin  ("You  took 
} //  close  if 
} //  close  while 
} //  close  main 


+ numOfGus 


chapter  5 


writing  a program 


pmp  code  test  code 


randomO  and  getUserlwputO 

Two  things  that  need  a bit  more 
explaining,  axe  on  this  page.  This  is 
just  a quick  look  to  keep  you  going; 
store  details  on  the  GameHelper 
class  are  at  the  end  of  this  chapter. 


Make  a random 
number 


TfeU  U » W,  and  i i n 

ty?e  of  ihetM  O.e.  the  ^ -1B  L, 

par^.  Alath.^dom  J*.'  ^ 


a^  V)  7n  +kWe  bfiwee"  0 

Jk  X 1 ^ ^ lops  off 

^ ^"^1  part  of  t|,e  d«3K. 


The  Math-nandom  method 
returns  a number  **on‘  *?rr  j, 
lust  lew  than  «*■  So  this  W*la 
V.th  the  east),  rrUms  a n^ber 

east  to  4"  wt) 


i 


int  randomNum  = (int)  (Math. randomO  * 

t p r 

A tUii  that  totfit*  A method  of  th e 
wi-tk  Java-  Math  elasi. 


S) 


Wc  declare  aw  mt  variable  "to  hold 
the  rawdow  number  we  get  baek 


7>is  »*iko d tot, 
fP***»i  tiJuesaSto*3 

» u!%Z  *“»  j a 

,hP “i 

String  guess  = helper. get Userlnput (“enter  a number”); 


Setting  user  input 
using  the  GameHelper 
class 


An  instance  we  made  earlier, 
of  a class  that  we  built  to 
help  with  'the  jame.  It  * called 
GameHelper  and  'you  haven’t 
seen  'rt  yet  (ye 


vou  wilW- 


T 


u/ulaire  3 s^rih9  va^l< 

ho  d the  user  Inpu-t  Stoino  v. 

9et  back  (uiu,  V,  ^ .). 3 


r 

A method  of  the  ^amettelyer 

that  asks  tbe  user  f or  Command— 
Ime  iwyuti  reads  it  iw  after  the 
user  hits  RETURN  awd  gives  back 
the  result  as  a String- 
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GameHelper  class  (Ready-bake) 


prep  code  test  code 


One  last  class.*  GameHelper 

We  made  the  dot  com  class. 

We  made  the  game  class. 

AD  that’s  left  is  the  helper  class — the  one  with  the 
getUserInput()  method.  The  code  to  get  comumand- 
line  input  is  more  than  we  want  to  explain  right  now. 
It  opens  up  way  too  many  topics  best  left  for  later. 
(Later,  as  in  chapter  14.) 


Just  copy*  the  code  below  and  compile  it  into 
a class  named  GameHelper.  Drop  all  three 
classes  (SimpleDotCom,  SimpleDot  Corn  Game, 
GameHelper)  into  the  same  directory,  and  make  it 
your  working  directory. 


@P 

c 


BPaadybata 

CaJe  logo,  you're  see- 
ing code  that  you  have  to  type  as-is  and  take  on  faith. 
Trust  iL  You'll  learn  how  that  code  works  later 


Readf-ba  ke 
Code 


import  ja.va.io.*; 
public  class  GameHelper  { 

public  String  getUser Input (String  prompt)  { 
String  inputLine  = null ; 

System. out .print (prompt  + " ") ; 

try  { 

Buf feredRaader  is  - new  BuffaredReadar ( 
new  InputStreamReader  (System,  in) ) ; 
inputLine  = is . resdLine () ; 

if  (inputLine . length ()  = 0 ) return  null; 
) catch  (lOException  a)  { 

System. out. println (“IOfixception : w + e) ; 

) 

return  inputLine; 
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*We  know  how  much  you  enjoy  typing,  but  for  those  rare 
moments  When  you‘d  rather  do  something  we've  made 
the  Ready-bake  Code  available  on  wlckedlysmartxom. 


Let's  play 


Here's  what  happens  when  we 
run  it  and  enter  the  numbers 
1,2,3,4,516.  Lookin'  good. 

A complete  game  Interaction 

(your  mileage  may  vary) 


writing  a program 


What's  this?  A bug ? 

Gaspl 

Here's  what  happens  when  we 
enter  1,1,1. 

A different  game  interaction 

(ylkes) 
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More  about  for  loops 

We’ve  covered  all  the  game  code  for  this  chapter  (but  we’ll  pick  it  up  again 
to  finish  the  deluxe  version  of  the  game  in  the  next  chapter).  We  didn’t 
want  to  interrupt  youx  work  with  some  of  the  details  and  background  info, 
so  we  put  it  back  here.  We’ll  start  with  the  details  of  for  loops,  and  if  you’re 
a C++  programmer,  you  can  just  skim  these  last  few  pages... 


Regular  (non-enhanced)  for  loops 


ike 


Dost-mtrewtot  opprak* 

l i 

for(int  i = 0;  i < 100;  i++)  { } 


/ 


T 

boolean  -best 


f 

iterate  en.yreis‘«o<N 


What  it  means  in  plain  English:  "Repeat  1 00  times/ 
How  the  compiler  sees  it: 

+ create  a variable  / and  set  It  to  0. 

* repeat  while  / Is  less  than  100. 

+ at  the  end  of  each  loop  Iteration,  add  1 to  / 


Part  One:  Initialization 

Use  this  part  to  declare  and  Initialize  a variable  to  use  within  the  loop  body. 
You’ll  most  often  use  this  variable  as  a counter  You  can  actually  initialize  more 
than  one  variable  here,  but  we'll  get  to  that  later  In  the  book. 

Part  Two:  boolean  test 

This  Is  where  the  conditional  test  goes.  Whatever's  In  there.  It  must  resolve  to  a 
boolean  value  (you  know,  true  or  fa/se).  You  can  have  a test  like  (x  >=4),  or  you 
can  even  invoke  a method  that  returns  a boolean. 

Part  Three:  iteration  expression 

In  this  part  put  one  or  more  things  you  want  to  happen  with  each  trip  through 
the  loop.  Keep  In  mind  that  this  stuff  happens  at  the  end  of  each  loop. 


repeat  for  100  reps: 
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lips  through  a loop 


*sr  lint  i = 0;  i < 8;  i++)  { 
System. out. println (i) ; 

5 


. out . println ("done" ) ; 


Rfftreitee  between  for  and  while 


tixr^foop  has  only  the  boolean  test;  It  doesn't  have 
initialization  or  Iteration  expression.  A while 
moc  5 good  when  you  don't  know  how  many  times  to 
tocc  and  just  want  to  keep  going  while  some  condi- 
tion s true.  But  If  you  know  how  many  times  to  loop 
e ; the  length  of  an  array,  7 times,  etc.),  a for  loop  Is 
rseo-er.  Here's  the  loop  above  rewritten  using  while: 


iat,  i = 0;  ^ ^ dec/^ 


^ Hit 


<J*d 


vhila  <i  < 8)  { ~~ 

System,  out .println (i) ; 
i++; 


**  hjvt  -f-  * 


System,  out  .println  ("done")  ; 


output: 

^i^di^wSndo^tei^Rewar 


%java  Test 
0 
1 
2 

3 

4 

5 

6 
1 

done 


++  — — 

Pre  and  Post  Increment/Decrement  Operator 

The  shortcut  for  adding  or  subtracting  1 from  a variable. 

X++ ; 

Is  the  same  as: 

x = x + 1; 

They  both  mean  the  same  thing  in  this  context 
"add  1 to  the  current  value  of  x'or  “Increment  x by  V 
And: 

x — ; 

Is  the  same  as: 

x = x - 1 ; 

Of  course  that's  never  the  whole  story.The  placement  of  the 
operator  {either  before  or  after  the  variable)  can  affect  the  re- 
sult. Putting  the  operator  before  the  variable  (for  example,  ++x), 
means, "first  increment  x by  1,and  then  use  this  new  value  of  xT 
This  only  matters  when  the  ++x  Is  part  of  some  larger  expres- 
sion rather  than  just  in  a single  statement. 

Int  x = 0;  int  z = -H-x; 

produces:  x Is  1,z  is  1 

But  putting  the  ++  after  the  x give  you  a different  result: 

int  x ^ 0;  int  z = x++; 

produces:  x Is  1,  but  z/s  0!  z gets  the  value  of  x and  then  x is 
Incremented. 
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enhanced  for 


The  enhanced  for  loop 

Beginning  with  Java  5.0  (Tiger),  the  Java  language  has  a second  kind  of  for  loop 
called  the  enhanced  for ; that  makes  it  easier  to  iterate  over  all  the  elements  in  an 
array  or  other  kinds  of  collections  (you’ll  learn  about  other  collections  in  the  next 
chapter) . That’s  really  all  that  the  enhanced  for  gives  you — a simpler  way  to  walk 
through  all  the  elements  in  the  collection  but  since  it’s  the  most  common  use  of  a 
for  loop,  it  was  worth  adding  it  to  the  language.  We’ll  revisit  the  enhanced  for  loop  in 
the  next  chapter,  when  we  talk  about  collections  that  aren't  arrays. 


1 ne  Ci 

Declare  a*  iteraW  variable  Ac  ( , ^pea^ 

that  will  hold  a m^e  eWe**  «//¥»  (bxe  to 

in  the  anray-  ^ , 

for  (String  name  : nameArray)  { } 

TL*  A-  , . With  each  iteration. 


n‘t°de  ie 


A<  elements  in  the 
array  AJWST  be 
Compatible  With  the 
declared  variable  type 


With  each  iteration, 
a differ e*t  element 
to  the  array  vi'll 

he  assiy^ed  to  the 
variable  “ra*»e  • 


. . , ivatvou  viar.t^'ter^oV" 

The  collection  of  ^e  Code  ia''d: 

Uay^e  that  somewhere  ean.e 

M x - tfred".  ^ ‘ c 

£brm^  n a^en™^/  ^ value  of 

u * \terdW>  V r ck 


What  It  means  in  plain  English:  "For  each  element  in  nameArray,  assign  the 
element  to  the ’name' variable,  and  run  the  body  of  the  loop." 


How  the  compiler  sees  it: 

* Create  a String  variable  called  name  and  set  It  to  null. 

* Asslgntheflrst  value  In  nameArray  to  name. 

+ Run  the  body  of  the  loop  (the  code  block  bounded  by  curly  braces). 

+ Assign  the  next  value  In  nameArray  to  name. 

+ Repeat  while  there  are  still  elements  in  the  array. 

Part  One:  Iteration  variable  declaration 

Use  this  part  to  declare  and  Initialize  a variable  to  use  within  the  loop  body.  With  each 
iteration  of  the  loop,  this  variable  will  hold  a different  element  from  the  collectlon.The 
type  of  this  variable  must  be  compatible  with  the  elements  in  the  array!  For  example, 
you  can't  declare  an  Int  Iteration  variable  to  use  with  a StringU  array. 

Part  Two:  the  actual  collection 

This  must  be  a reference  to  an  array  or  other  collection.  Again,  don't  worry  about  the 
other  non-array  kinds  of  collections  yet— you'll  see  them  In  the  next  chapter. 


e*hahded  to*  « 

ft*  U titi  or 
,h  bow  H 

1.1 


116  chapter  5 


writing  a program 


Converting  a String  to  an  int 

int  guesB  - Integer  (stringGuess) ; 

The  user  types  his  guess  at  the  command- 
line,  when  the  game  prompts  him. That 
guess  comes  In  as  a String  ("270“ etc.) , 
and  the  game  passes  that  String  into  the 
checkVourselfO  method. 

But  the  cell  locations  are  simply  ints  In  an 
array,  and  you  can't  compare  an  Int  to  a 
String. 

For  example,  this  won't  work ; 

String  num  = "2"; 
int  x = 2; 

jf(x=num)  If  horrible  explosionl 

Trying  to  compile  that  makes  the  compiler 
laugh  and  mock  you: 


operator  ==  cannot  be  applied  to 
int, java , lang . String 

if  (x  = num)  { J 


So  to  get  around  the  whole  apples  and 
otranges  thing,  we  have  to  make  the  String 
'2* into  the  int  2.  Built  Into  the  Java  class 
f^brary  is  a class  called  Integer  {that's  right 
an  Integer  class , not  the  int  primitive), 
and  one  of  its  Jobs  is  to  take  Strings  that 
represent  numbers  and  convert  them  into 
actual  numbers. 


i 


3 S'tv-inj 

*L 

Integer.parselnt  (“3”) 

/ 


d rrrt^vod  ih  tki  Ih'fcefiev- 
knows  how  to 

yf™*"  a into  tkc 


Casting 

"rtrt 


can  be  cast  to 


but  you  might 
lose  something 


short 


0*  kfi 

***  off 


In  chapter  3 we  talked  about  the  sizes  of  the  various  primitives,  and  how  you 
can't  shove  a big  thing  directly  Into  a small  thing: 
long  y = 42; 

Int  x = y;  //  won't  compile 

A long  is  bigger  than  an  int  and  the  compiler  can  t be  sure  where  that  tong  has 
been.  It  might  have  been  out  drinking  with  the  other  longs,  and  taking  on  really 
big  values.  To  force  the  compiler  to  Jam  the  value  of  a bigger  primitive  variable 
into  a smaller  one,  you  can  use  the  cast  operator.  It  looks  like  this: 

long  y = 42;  //  so  fax  so  good 

int  x = (int)  y;  //  x = 42  cool! 

Putting  In  the  c^st  tells  the  compiler  to  take  the  value  of  y,  chop  It  down  to  int 
size,  and  set  x equal  to  whatever  Is  left.  If  the  value  of  y was  bigger  than  the 
maximum  value  of  x,  then  what's  left  will  be  a weird  (but  calculable4)  number: 

long  y = 40002; 

//  40002  exceeds  the  16^bit  limit  of  a short 


short  x = (short)  y;  //  x now  equals  -25534! 

Still,  the  point  is  that  the  compiler  lets  you  do  it.  And  let's  say  you  have  a float- 
ing point  number,  and  you  just  want  to  get  at  the  whole  number  (/rtf)  part  of  it 


float  f = 3 . 1 4 f ; 

int  x = (int)  £ ; //  x will  equal  3 

And  don't  even  think  about  casting  anything  to  a boolean  or  vice  versa— just 
walk  away. 

4/(  involves  sign  bits , binary ; two’s  complement ’ and  other  geekery,  aft  of  which 
are  discussed  at  the  beginning  of  appendix  B. 
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exercise:  Be  the  JVM 


BE  tk&  JVM 


The  Java  file  on  this  page 
represents  a complete  source 
file.  Your  job  is  to  play  JVM 
and  determine  what  would  be 
the  output  when  the 
program  runs? 


class  Output  { 


ne  £$  Whto i H^p  OM 


% java  Output 
12  14 


public  static  void  main (String  []  args ) { 
Output  o = new  Output(); 
o.go( ) ; 


-or- 


void  go()  { 
int  y = 7; 

for(int  x = 1;  x < 8;  x++)  { 
y++; 

if  (x  > 4)  { 

Systenwout. print (++y  + " " ) ; 


File  6M  Wrekw  Hefo  Irtatss 


% java  Output 
12  14  x = 6 


-or- 


if  (y  > 14)  { 

System. out. println ( " x = " + x); 
break; 

> 

> 


Fite  B<fc  Wiitjcw  Hafc  BeHeve 


% java  Output 
13  IS  r.  = 6 


> 

} 


118  chapters 


writing  a program 


A working  Java  program  is  all  scrambled  up  on  the  fridge.  Can  you 
reconstruct  the  code  snippets  to  make  a working  Java  program  that 
produces  the  output  listed  below?  Some  of  the  curly  braces  fell  on  the 
floor  and  they  were  too  small  to  pick  up,  so  feel  free  to  add  as  many  of 
those  as  you  need! 
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JavaCross 


How  does  a crossword  puzzle 
help  you  learn  Java?  Well,all 
of  th  e words  are  Java  related. 
In  addition, the  clues  provide 
metaphors,  puns,  and  the  like. 
These  mental  twists  and  turns 
bum  alternate  routes  to  Java 
knowledge,  right  into  your 
brainl 


Across 

T Fancy  computer  word 
for  build 

4.  Multi-part  loop 

6,  Test  first 

7.  32  bits 

10.  Method's  answer 
IT  Prepcode^esque 
13.  Change 
15.  The  big  toolkit 

17.  An  array  unit 

18.  Instance  or  local 


20.  Automatic  toolkit 

22.  Looks  like  a primitive, 
but- 

25.  Un-castable 

26.  Math  method 

28.  Converter  method 

29,  Leave  early 


Down 

2.  Increment  type 

3.  Gass's  workhorse 

5.  FTelsatypeof 

6.  Fort  Iteration 

7.  Establish  first  value 

8.  While  or  For 

9.  Update  an  Instance  variable 
1 2.  Towards  blastoff 

14.  A cycle 

1 6.  Talkative  package 

19.  Method  messenger 
(abbrev.) 


21.  As  if 

23.  Add  after 

24.  Pi  house 

26.  Compile  It  and 

27.  ++  quantity 


writing  a program 


Messages 


A short  Java  program  is  listed  below.  One  block  of  the  program 
is  missing,  Your  challenge  Is  to  match  the  candidate  block  of 
code  (on  the  left),  with  the  output  that  you'd  see  if  the  block 
were  inserted,  Not  all  the  lines  of  output  will  be  used, and  some 
of  the  lines  of  output  might  be  used  more  than  once.  Draw  lines 
connecting  the  candidate  blocks  of  code  with  their  matching 
command-line  output. 


class  MixFor5  { 

public  static  void  main (String  []  args)  ( 
int  x = 0; 


int  y = 30; 

for  (int  outer  = 0;  outer  < 3;  outer++)  { 
for (int  inner  = 4;  inner  > 1;  inner--)  { 


) 


y = y - 2; 
if  (x  ==  6)  { 

break; 

) 

x = x + 3 ; 

} 

y = y - 2; 

} 

System. out .println (x  + " u + 


tode 


y>; 


Candidates: 


Possible  output: 


x = x + 3; 

45  6 

x = x + 6; 

one  of 

x •>  x + 2; 

54  6 

x++ ; 

€0  10 

X— f 

18  6 

x = x + 0; 

6 14 

12  14 
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Exercise  Solutions 


Be  the  JVM: 

class  Output  { 

public  static  void  main (String  [J  args)  { 
Output  o = new  Output ( ) ; 
o. go( ) ; 

} 

void  go{ ) { 
int  y = 7; 

for(int  x = 1;  x < B;  x++)  { 
y++; 

if  (x  > 4)  { 

System- out . print ( ++y  + " 

> 

if  (y  > 14)  < > 

System. out . printing " x = " + x); 
break; 

> 

} 


) bid  you  remember  to  factor  in  the 

break  statement?  How  did  that 
affect  the  output? 

I FHi  Edit 


\ java  Output 
13  15  x = 6 


Code  Magnets: 

class  MultiFor  { 

public  static  void  main (String  []  args)  { 

for (int  x = 0;  X < 4;  x++)  { 

for  (int  y = 4;  y > 2;  y— ) { 

System. out. println(x  + " " + y); 

> 


if  (x  ==  1)  < 
x++ ; 

> 

> 

> 

fte  fcfil  WndowHefc  UxcCOte 


t java  MultiFor 
0 4 

0 3 

1 4 
1 3 
3 4 
3 3 


What  would  happen 
if  this  code  block  came 
before  the  *y‘  for  loop? 
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puzzle-  Solutions 


jU 

A 

N 

W 

bi 

|M) 

D 

r 

N 

n 

w* 

R 

Ej 

AlK 

Candidates: 

Possible  output: 

x » x + 3; 

45  6 

x « x + 6} 

36  6 

x » x + 2) 

- X ^ 54  6 

x++; 

60  10fl| 

x—; 

18  6 

x ■ x + 0) 

6 14 

12  14 
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Using  the  Java  Library 


Java  ships  with  hundreds  of  pre-built  classes.  You  don't  have  to 

reinvent  the  wheel  If  you  know  how  to  find  what  you  need  in  the  Java  library,  known  as 
the  Java  API,  You've  got  better  things  to  do.  If  you're  going  to  write  code,  you  might  as  well 
write  only  the  parts  that  are  truly  custom  for  your  application.  You  know  those  programmers 
who  walk  out  the  door  each  night  at  5 PM?  The  ones  who  don't  even  show  up  until  1 0 AM? 
They  use  the  Java  API.  And  about  eight  pages  from  now,  so  will  you.The  core  Java  library 
Is  a giant  pile  of  classes  just  waiting  for  you  to  use  like  building  blocks,  to  assemble  your  own 
program  out  of  largely  pre-bullt  code, The  Ready-bake  Java  we  use  in  this  book  Is  code  you 
don't  have  to  create  from  scratch,  but  you  still  have  to  type  It.The  Java  API  is  full  of  code  you 
don't  even  have  to  type.  All  you  need  to  do  is  learn  to  use  it. 


this  Is  a new  chapter  1 25 


we  still  have  a bug 


In  oor  last  chapter:  we  left  you 
with  the  cliff-hanger:  A bug. 


How  it's  supposed  to  look  How  the  bug  looks 


Here's  what  happens  when  we 
run  it  and  enter  the  numbers 
1,2, 3, 4,5,6.  Lookin'  good. 

A complete  game  Interaction 

(your  mileage  may  vary) 

| File  Edit  Window  Help  Smile  | 


java  SimpleDotComGaxne 
enter  a number  1 
miss 

enter  a number  2 
miss 

enter  a number  3 
miss 

enter  a number  4 
hit 

enter  a number  5 
hit 

enter  a number  6 
kill 

You  took  6 guesses 


Here's  what  happens  when  we 
enter  2,2,2. 


A different  game  interaction 

(yikes) 

I File  EdH "^/indo^Help  Fslnl  | 


%java  SimpleDotComGame 
enter  a number  2 
hit 

enter  a number  2 
hit 

enter  a number  2 
kill 

You  took  3 guesses 


In  the  current  version,  once 
you  get  a hit,  you  can  simply 
repeat  that  hit  two  more 
times  for  the  killl 
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So  what  happened? 


public  String  checkYour self (String  stringGueas)  ( 


Int  guess  = Integer .p&rselnt  (stringGueas)  ; ^ Cvr\*orl  th* 

to  <5n  inf. 

String  result  = "miss";  ^ M&t  a variable  ^ r*-jj 


reW  pui  ", 


. we  I 


(,  e-  *<  **«•*  a u»i«“>. 


■"“*  the  default 


Here’s  where  It 
goes  wrong.  We 
counted  a hit  every 
time  the  user 
guessed  a cell 
location,  even  If 
that  location  had 
already  bean  hitl 

We  need  a way  to 
know  that  when 
a user  makes 
a hit,  he  hasn’t 
previously  hit  that 
cell.  If  he  has,  then 
we  don’t  want  to 
count  It  as  a hit. 


for  (int  call  : locationCells)  { 


3^  i*  tki*  element 

(tell),  in  the  array. 


<h3  the  Jt-yjy 


} 


break ; 


//  end  if 


of  the  I 
**  ihe  othe 


°°P'  no  need 
*■  tells. 


} //  end  for 


if  (msaOfHits  = locationCells . length) 
result  = "kill"; 

} //  end  if 


WeVe  out  of  toe  loop,  Wfc 

W » see  if  weVe  how  'dead' 
^hit  5 times)  and  change  toe 
result  Stoirg  to  “kid". 


Syefcem.  out. println  (result) ; Display  toe  result  for  toe  user 

, . f wiss”,  unless  if  was  changed  to  “hit"  or  “kill”), 

return  result;  J 

Return  toe  result  back  to 

) //  end  method  Die  Calling  method. 
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How  do  we  fix  itt 


We  need  a way  to  know  whether  a cell  has  already  been  hit.  Let's  run 
through  some  possibilities,  but  first,  well  look  at  what  we  know  so  far... 

We  have  a virtual  row  of  7 cells,  and  a DotCom  will  occupy  three 
consecutive  cells  somewhere  in  that  row.  This  virtual  row  shows  a 
bottom  placed  at  cell  locations  4,5  and  6. 


The  botCom  has  an  instance  variable— an  int  array— that  holds  that 
bottom  object's  cell  locations. 


locatlonlells 
(instance  variable  of 
the  botCom) 


% Bud  k ~n 

^ Wfr  Heeds  U 3^2  ^ """I** 


Option  one 

We  could  make  a second  array,  and  each  time  the  user  makes  a hit,  we 
store  that  hit  in  the  second  array,  and  then  check  that  array  each  time 
we  get  a hit,  to  see  if  that  cell  has  been  hit  before. 


hltlells  array 

(this  would  be  a 
new  boolean  array 
instance  variable  of 
the  botCom) 


false  *a'se  *rue 

bis  Is 

,0,0 


u\\  ^ meaM 

^ 0THER 
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Option  one  is  too  clunky 

Option  one  seems  like  more  work  than  you'd  expect.  It  means  that  each 
time  the  user  makes  a hit,  you  have  to  change  the  state  of  the  second 
array  (the  'hitCells’  array),  oh  — but  first  you  have  to  CHECK  the  'hitCells' 
array  to  see  if  that  cell  has  already  been  hit  anyway.  It  would  work,  but 
there's  got  to  be  something  better... 


^ Option  two 

We  could  just  keep  the  one  original  array,  but  change  the  value  of  any  hit 
cells  to  -1.  That  way,  we  only  have  ONE  array  to  check  and  manipulate 


locattonCells 
(instance  variable  of 
the  Do+Com) 


. . .f 

.O.tj.o 

I ° I 1 \ 2 


Option  two  Is  a little  better,  but 
still  pretty  clunky 

Option  two  is  a little  less  clunky  than  option  one,  but  it's  not  very  efficient.  You'd 
still  have  to  loop  through  all  three  slots  (index  positions)  in  the  array,  even  if 
one  or  more  are  a/ready  invalid  because  they've  been  'hit'  (and  have  a -1  value). 
There  has  to  be  something  better... 
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prep  code 

prep  code  Idtnt  code 


real  code 


Option  three 

We  delete  each  cell  location  as  it  gets  hit,  and  then  modify  the  array  to 
be  smaller.  Except  arrays  can't  change  their  size,  so  we  have  to  make  a 
new  array  and  copy  the  remaining  cells  from  the  old  array  into  the  new 
smaller  array. 

4 5 6 


locatfonCells  array 
BEFORE  any  cells 
have  been  hit 


0,0.0 


Jw  ^ r4  *ltt » «« 

tie  fell  *4 


locatlonCehs  array 
AFTER  cell  ‘5',  which 
was  at  index  1 in  the 
array,  has  been  hit 


o*  array  wi+u  l l * 

™ \ di5j.  . I , , 

"■■S'"4'  « W,  ttt 


Option  three  would  be  much  better  if  the  array  could  shrink,  so  that  we  wouldn't  have 
to  make  a new  smaller  array  copy  the  remaining  values  in,  and  reassign  the  reference. 


The  original  prepcode  for  part  of  the  Life  would  be  good  If  only  we  could 

checkYourself  0 method:  change  It  to: 


REPEAT  with  each  of  the  location  cells  in  the  int  array 
H COMPARE  the  user  guess  to  the  location  cell 
I F the  user  guess  matches 

INCREMENT  the  number  of  hits  

//  FiND  OUT  if  ft  was  the  last  location  cell; 

IF  number  of  hits  is  3.  RETURN  "kill”  

ELSE  it  was  not  a kill,  so  RETURN  S" 
END  IF 


ELSE  user  guess  did  not  match,  so  RETURN  "miss” 
END  IF 
END  REPEAT 


^ REPEAT  with  each  of  the  remaining  location  cells 
//  COMPARE  the  user  guess  to  the  location  cell 
IF  the  user  guess  matches 
^ REMOVE  this  cell  from  the  array 

fi  FfND  OUT  if  it  was  the  last  location  cell: 

^ I IF  the  array  is  now  empty,  RETURN  “kill" 
ELSE  it  was  not  a kill,  so  RETURNW 
END  IF 

ELSE  user  guess  did  not  match,  so  RETURN  "miss" 
END  IF 
END  REPEAT 
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If  only  I could  find  on  array  ^ 
that  could  shrink  when  you  remove 
something.  And  one  that  you  didn’t  have 
to  loop  through  to  check  each  element,  but 
instead  you  could  just  ask  it  If  it  contains 
what  you're  looking  for.  And  it  would  let  you 
get  things  out  of  it,  without  having  to  know 
exactly  which  slot  the  things  are  in. 

That  would  be  dreamy.  But  I know  it's 
^ just  a fantasy... 


when  arrays  aren’t  enough 


Wake  up  and  smell  the  library 


As  If  by  magic,  there  really  Is  such  a thing. 
But  it’s  not  an  array,  it’s  an  ArrayList. 


A class  in  the  core  Java  library  (the  API). 

The  Java  Standard  Edition  (which  is  what  you  have  unless  you’re  work- 
ing on  the  Micro  Edition  for  small  devices  and  believe  me,  you'd  know) 
ships  with  hundreds  of  pre-built  classes.  Just  like  our  Ready-BaJke  code 
except  that  these  built-in  classes  are  already  compiled. 


That  means  no  typing. 
Just  use  'em. 


Arrays 


Or\t  ©t  a ftazjlltcn  classes  in 

the  Java  fibvary- 

You  dan  use  it  in  youv  dode 
as  i-f  you  wrot t it  yowrselt- 


Return  true 


(Nahe  the  addWijjftt  elem)  method 
actually  looks  a little  xtranyir  than  the 
one  weW  shown  heve^  well  get  to  the 
real  one  later  in  the  book.  For  now,  just 
think  of  it  as  an  addO  method  that 
takes  the  ©bjedt  you  want  to  add  ) 


IsEmptV^  ,true-  \f  the  list  has  no  elements 

Returns  tru 


, of 


currently  in  the  list 


•rf^*,*.*""*-** 


index  parameter 

7^.  j •* 


7.7 
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Some  things  you  can  do  with  Arrayllst 


D„’t  ^ 

Make  one  vi^ht  now,  vt  jwt  «"  ^ 

ArrayList<Egg>  myList  = new  ArrayList<Egg>  () ; AvvavU*t  t. 


Put  something  in  it 
Egg  s = new  Egg ( ) ; 

myList .add (s) ; 


Kow  the  ArrayUisi  vy*  a ^ 
to  hold  the  % flbjett' 


Put  another  thing  in  it 
Egg  b = new  Egg(); 

myList .add (b) ; 


Find  out  how  many  things  are  in  it  . . . , . ■ 

1 y > ^ The  A"*^*  “ 

int  theSize  = myList  .size  () ; 4r"^  the  method 


TW  Avra'/List  « hold^  2-ohjetts  *> 
l.  . -ethod  vetwms  4s. 


Find  out  if  it  contains  something  The  A«‘d'/L'«t  tonta  , ^ iiu t 

l/  t ,.JU|V  m eontainiO  retunm  x.rv*i; 
boolean  isln  = myList  .contains  (s)  ; ^ vet  evented  wy  ► 

, . hated  (means  •fivst  <nde*  14  ^ 

Find  out  where  something  is  (i.e.  its  index)  A*^'/1'*5*  IS  z^0"’,  f~*-/.ed  W V was  -the 

int  idx  = myList  .indaxOf  (b)  ; K and  s>nte  vcb*vns  I 


© Find  out  if  it's  empty 


boolean  empty  = myList.isEmpty  ()  ; t — ’ -Pjjsg 


Remove  something  from  it 
myList . remove ( s ) ; 


Q> 


tt*Y  I ock  — ii  sto-ank! 
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when  arrays  aren't  enough 

Fill  In  the  rest  of  the  table  below  by  looking  at  the  ArrayList  code 
on  the  left  and  putting  in  what  you  think  the  code  might  be  if  it 
were  using  a regular  array  Instead.  We  don't  expect  you  to  get  all 
of  them  exactly  right,  so  Just  make  your  best  guess. 


Arraylist 


regulararray 


ArrayList<$tring>  myList  =■  new 
ArrayL±st<String> () ; 

String  □ wyList  — *e*/  SirinjCZJ; 

String  a = new  String ("whoohoo") ; 

Sbrmg  a =•  htw 

myList. add(a) ; 

String  b - new  String ("Frog") ; 

b — hew  Sirih^FrojOj 

myList . add (b) ; 

int  theSize  = myList .size () ; 

Object  o = myList .get (1) ; 

myList . remove (l ) ; 

boolean  isln  - myList . contains (b) ; 
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iJSSingeafens 


Q,-  So  ArrayList  (s  cool,  but 
how  would  I know  h exists? 


Java  fttpostd: 

This  week’s  Interview: 

ArrayList,  on  arrays 


,^\lThe  question  Is  really, 

'How  do  I know  what's  In  the 
API?*  and  that's  the  key  to  your 
success  as  a Java  programmer. 
Not  to  mention  your  key  to 
being  as  lazy  as  possible  while 
still  managing  to  build  software. 
You  might  be  amazed  at  how 
much  time  you  can  save  when 
somebody  else  has  already  done 
most  of  the  heavy  lifting,  and 
all  you  have  to  do  is  step  in  and 
create  the  fun  part. 

But  we  digress...  the  short 
answer  is  that  you  spend  some 
time  learning  what's  In  the  core 
API.  The  long  answer  is  at  the 
end  of  this  chapter,  where  you'll 
learn  how  to  do  that. 


0/  But  that's  a pretty  big 
issue.  Not  only  do  I need  to 
know  that  the  Java  library 
comes  with  ArrayList  but  more 
Importantly  I have  to  know 
that  ArrayList  Is  the  thing  that 
can  do  what  I wantl  So  how 
do  I go  from  a need-to-do- 
something to  a-way-to-do-lt 
using  the  API? 


A- 

*\-Now  you're  really  at  the 
heart  of  it.  By  the  time  you've 
finished  this  book, you'll  have 
a good  grasp  of  the  language, 
and  the  rest  of  your  learning 
curve  really  Is  about  knowing 
how  to  get  from  a problem  to 
a solution,  with  you  writing  the 
ieast  amount  of  code.  If  you  can 
be  patient  for  a few  more  pages, 
we  start  talking  about  It  at  the 
end  of  this  chapter. 


HeadFIrst:  So,  Arraylists  are  like  arrays,  right? 

ArrayList:  In  their  dreams!  / am  an  object  thank  you  very  much. 

Headfirst;  If  I'm  not  mistaken,  arrays  are  objects  too.  They  live  on  the  heap  right 
there  with  all  the  other  objects. 

ArrayList:  Sure  arrays  go  on  the  heap,  duh1  but  an  array  is  still  a wanna-be 
ArrayList.  A poser.  Objects  have  state  and  behavior,  right?  We're  dear  on  that.  But 
have  you  actually  tried  calling  a method  on  an  array? 

Head  First  Now  that  you  mention  it,  can't  say  I have.  But  what  method  would  I 
call,  anyway?  I only  care  about  calling  methods  on  the  stuff  I put  in  the  array,  not 
the  array  itself.  And  I can  use  array  syntax  when  I want  to  put  things  in  and  take 
things  out  of  the  array. 

ArrayList;  Is  that  so?  You  mean  to  tell  me  you  actually  remooed  something  from  an 
array?  (Sheesh,  where  do  they  train  you  guys?  Mqjava's?) 

HeadFIrst:  Of  course  I take  something  out  of  the  array.  I say  Dog  d - dogArrayfl] 
and  I get  the  Dog  object  at  index  1 out  of  the  array. 

ArrayList  Allright,  PU  try  to  speak  slowly  so  you  can  follow  along  You  were  not, 

1 repeat  not,  removing  that  Dog  from  the  array  All  you  did  was  make  a copy  of  the 
reference  to  the  Dog  and  assign  it  to  another  Dog  variable. 

HeadFIrst:  Oh,  I see  what  you're  saying  No  I didn’t  actually  remove  the  Dog 
object  from  the  array.  It's  still  there.  But  I can  just  set  its  reference  to  null,  I guess. 

ArrayList:  But  Pm  a first-class  object,  so  I have  methods  and  I can  actually,  you 
know,  do  things  like  remove  the  Dog's  reference  from  myself,  not  just  set  it  to  null. 
And  I can  change  my  size,  dynamically  (look  it  up).  Just  try  to  get  an  array  to  do  that! 

HeadFIrst  Gee,  hate  to  bring  this  up,  but  the  rumor  is  that  you’re  nothing  more 
than  a glorified  but  less-efficient  array.  That  in  fact  you’re  just  a wrapper  for  an 
array,  adding  extra  methods  for  things  like  resizing  that  I would  have  had  to  write 
myself  And  while  we’re  at  it  yyou  can’t  even  hold  primitives}  Isn't  that  a big  limitation? 

ArrayList;  I can’t  believe  you  buy  into  that  urban  legend.  No,  I am  not  just  a less- 
effident  array.  I will  admit  that  there  are  a few  extremely  rare  situations  where  an 
array  might  be  just  a tad,  I repeat,  tad  bit  faster  for  certain  things.  But  is  it  worth  the 
miniscule  performance  gain  to  give  up  all  this  power . Still,  look  at  all  this  flexibility.  And 
as  for  the  primitives,  of  course  you  can  put  a primtive  in  an  ArrayList,  as  long  as  it's 
wrapped  in  a primitive  wrapper  class  (you'll  see  a lot  more  on  that  in  chapter  1 0). 
And  as  of  Java  5.0,  that  wrapping  (and  unwrapping  when  you  take  the  primitive  out 
again)  happens  automatically  And  allright,  I'll  acknowledge  that  yes,  if  you're  using  an 
ArrayList  of  primitives , it  probably  is  faster  with  an  array,  because  of  all  the  wrapping 
and  unwrapping  but  still...  who  really  uses  primitives  these  days? 

Oh,  look  at  the  time!  Pm  late fir  Pilales  We’ll  have  to  do  this  again  sometime. 
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Comparing  ArrayList  to  a regular  array 


ArrayLUt 


regulararray 


ArrayList<String>  myList  = new  String  []  myList  = new  String[2J; 

ArrayList<String> ( ) ; 


boolean  isln  = myList . contains (b) 


boolean  isln  = false; 

for  (String  item  : myList)  { 


if  (b. equals (item) ) { 
isln  = true; 
break; 

} 

) 


Notice  how  with  ArrayList,  you’re  working  With  an  array , you  use  special  array  syntax  (like 

with  an  object  of  type  ArrayList,  so  you’re  just  myList  [0]  = foo)  that  you  won’t  use  anywhere 

invoking  regular  old  methods  on  a regular  old  else  except  with  arrays.  Even  though  an 

object,  using  the  regular  old  dot  operator  array  is  an  object,  it  lives  in  its  own  special 

world  and  you  can’t  invoke  any  methods  on 
it,  although  you  can  access  its  one  and  only 
instance  variable,  length. 
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0 A plain  old  array  has  to  know  its 
size  at  the  time  it’s  created. 

But  for  ArrayList,  you  just  make  an  object  of 
type  Arraylist.  Every  time.  It  never  needs  to 
know  how  big  it  should  be,  because  it  grows 
and  shrinks  as  objects  are  added  or  removed. 

new  String[2]  ~Nwds  a *** 

new  ArrayList<String> ( ) 

Mo  s\ze  required  (alihowjK  you 
give  ii  a iizt  you  io). 

0 To  put  an  object  in  a regular  array, 
you  must  assign  it  to  a specific 
location. 

(An  index  from  0 to  one  less  than  the  length  of 
the  array.) 

myList[l]  = b; 

Meeds  an  inde^* 

If  that  index  is  outside  the  boundaries  of  the 
array  (like,  the  array  was  declared  with  a size  of 
2,  and  now  you’re  trying  to  assign  something 
to  index  3) , it  blows  up  at  runtime. 

With  Arraylist,  you  can  specify  an  index  us- 
ing the  add(anlnt,  anObject)  method,  or  you 
can  just  keep  saying  add(anObject)  and  the 
Arraylist  will  keep  growing  to  make  room  for 
the  new  thing. 
myList .add (b) ; 

index. 


^ Arrays  use  array  syntax  that's  not 
used  anywhere  else  in  Java. 

But  ArrayLists  are  plain  old  Java  objects,  so 
they  have  no  special  syntax. 

myList [1] 

The  away  Wacket*  H « ^ 
syyvia*  avraYs* 


0 ArrayLists  in  Java  5.0  are 
parameterized. 

We  just  said  that  unlike  arrays,  ArrayLists 
have  no  special  syntax.  But  they  do  use 
something  special  that  was  added  to  Java  5.0 
Tiger — parameterized  types . 

ArrayList<String> 

The  <S-forih3>  '•»  brackets  is  a "type 
parameter' . /WayLisi<Siv-mg>  means  simply  "a 
list  o(  Strings , as  opposed  to  ArrayList<Dog> 
which  means,  "a  list  i &<>¥"■ 

Prior  to  Java  5.0,  there  was  no  way  to  declare 
the  type  of  things  that  would  go  in  the 
ArrayList,  so  to  the  compiler,  all  ArrayLists 
were  simply  heterogenous  collections  of 
objects.  But  now,  using  the  <typeGoesHere> 
syntax,  we  can  declare  and  create  an 
ArrayList  that  knows  (and  restricts)  the 
types  of  objects  it  can  hold.  We’ll  look  at  the 
details  of  parameterized  types  in  ArrayLists 
in  the  Collections  chapter,  so  for  now,  don’t 
think  too  much  about  the  angle  bracket  <> 
syntax  you  see  when  we  use  ArrayLists.  Just 
know  that  it’s  a way  to  force  the  compiler  to 
allow  only  a specific  type  of  object  (the  type  in 
angle  brackets)  in  the  ArrayList. 


the  buggy  DotCom  code 

prop  code 


Let's  fix  the  PotCom  code. 


Remember,  this  is  how  the  buggy  version  looks: 


public  class  DotCom  [ 


int ( ] locationCells; 
int  numOfHits  = 0; 


public  void  setLocationCells (int [ ] Iocs)  { 
locationCells  - Iocs; 

) 


public  String  checkYourself (String  stringGuess)  ( 
int  guess  =>  Integer ,parselnt (stringGuess) ; 
String  result  = "miss"; 


for  (int  cell  : locationCells)  { 

T if  (guess  cell)  { 

result  « "hit*; 
numOftUt  s++f 


break; 

) 

) //  out',  of  the  loop 


if  (numOfHits  ==  locationCells . length)  ( 
result  ■=  "kill"; 

) 

System. out .println (result) ; 
return  result; 

} //  close  method 
) //  close  class 
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prep  code  test  code 


New  and  improved  PotCom  class 


1/  ^ t»,  u 

import  java . util  .ArrayList;  ;i  'l**  talk 

public  class  DotCom  { 1 ^r' 


private  ArrayLis t<String>  locationCells; 

//  private  int  nurrOftJit^; 


//  don't  need  that  now  tV,C  £Vm$  irri1 


public  void  setLocationCells  <ArrayList<String>  loc)  ( 

locationCells  = loc;  m-vwtd  *x°} 

) - a"4 


the 


. , -c  XVic  us*r  vs  ITS  t,nc 

public  String  checkYourself (String  userlnput)  ( pmd  ovt  j , 

v-rtv^rvS  3 -l- 


String  result  = "miss"; 

int  index  = locationCells . indexOf (userlnput) ; 
if  (index  >=  0)  { ^ 


— — If  -iZ  Ateakv  il. 

locationCells  . remove  (index)  ; ^ *>  ;£  ;h  ^ 


if  (locationCells . isEmpty ( ) ) { 

result  - "kill"; 

) else  ( 

result  - "hit"; 

) //  close  if 

} //  close  outer  if 


|f  tKc  lU-t  vs 

killmsUow. 


return  result; 
} II  close  method 
) //  close  class 
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making  the  DotComBust 


let's  build  the  HEAL  game: 

'Sink  a Pot  Cow' 

We’ve  been  working  on  the  ‘simple1  version,  but  now 
let's  build  the  real  one.  Instead  of  a single  row,  we'll 
use  a grid.  And  instead  of  one  DotCom,  we’ll  use 
three. 

Goal:  Sink  all  of  the  computer’s  Dot  Corns  in  the 
fewest  number  of  guesses.  You’re  given  a rating  level 
based  on  how  well  you  perform. 

Setup:  When  the  game  program  is  launched,  the 
computer  places  three  Dot  Corns,  randomly,  on  the 
virtual  7x7  grid.  When  that’s  complete,  the  game 
asks  for  your  first  guess. 

How  you  play;  We  haven’t  learned  to  build  a GUI 
yet,  so  this  version  works  at  the  command-line.  The 
computer  will  prompt  you  to  enter  a guess  (a  cell), 
which  you’ll  type  at  the  command-line  (as  “A3",  UC5”, 
etc.).  In  response  to  your  guess,  you'll  see  a result  at 
the  command-line,  either  “hit",  “miss’'’,  or  “You  sunk 
Pets.com”  (or  whatever  the  lucky  Dot  Com  of  the  day 
is).  When  you’ve  sent  all  three  Dot  Corns  to  that  big 
404  in  the  sky,  the  game  ends  by  printing  out  your 
rating. 

tatV>  W- 

nyn  v*  a 


§ 
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itS.CC 
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Me.c 
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start*  at  zato,  like  Java  arrays 


You’re  going  to  build  the 
Sink  a DotCom  game,  with 
a 7 x 7 grid  and  three 
Dot  Corns.  Each  Dot  Com 
takes  up  three  cells. 


part  of  a game  interaction 


1 File  Edh 

Window  Hefp  Seit 

i 

% java 

DotComBust 

Enter 

a guess 

A3 

miss 

Enter 

a guess 

B2 

miss 

Enter 

a guess 

C4 

miss 

Enter 

a guess 

D2 

hit 

Enter 

a guess 

D3 

hit 

Enter 

a guess 

D4 

Ouch! 

You  sunk 

Pets  > com 

: ( 

kill 

Enter 

a guess 

B4 

miss 

Enter 

a guess 

63 

hit 

Enter 

a guess 

64 

hit 

Enter 

a guess 

G5 

Ouch! 

You  sunk 

AskMe . com 

: ( 
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What  needs  to  change? 

We  have  three  classes  that  need  to  change:  the 
DotCom  class  (which  is  now  called  DotCom  instead  of 
SimpleDotCom),  the  game  class  (DotComBust)  and  the 
game  helper  class  (which  we  won’t  worry  about  now) . 

Q DotCom  class 

© Add  a name  variable 

to  hold  the  name  of  the  DotCom 
(“Pets.com”,  “Go2.com”,  etc.)  so  each  Dot- 
Com  can  print  its  name  when  it’s  killed  (see 
the  output  screen  on  the  opposite  page) . 

Q DotComBust  class  (the  game) 

© Create  three  DotComs  instead  of  one. 

© Give  each  of  the  three  DotComs  a name. 

Call  a setter  method  on  each  DotCom 
instance,  so  that  the  DotCom  can  assign  the 
name  to  its  name  instance  variable. 


DotComBust  class  continued... 

© Put  the  DotComs  on  a grid  rather  than 
just  a single  row,  and  do  it  for  all  three 
DotComs. 

This  step  is  now  way  more  complex  than 
before,  if  we’re  going  to  place  the  DotComs 
randomly.  Since  we’re  not  here  to  mess 
with  the  math,  we  put  the  algorithm  for 
giving  the  DotComs  a location  into  the 
GameHelper  (Ready-bake)  class. 

© Check  each  user  guess  with  all  three 
DotComs , instead  of  just  one. 

© Keep  playing  the  game  (i.e  accepting 
user  guesses  and  checking  them  with  the 
remaining  DotComs)  until  there  are  no  more 
live  DotComs. 

© Get  out  of  main.  We  kept  the  simple  one  in 
main  just  to...  keep  it  simple.  But  that’s  not 
what  we  want  for  the  real  game. 


3 Classes: 


. ..rtond  to  moke 

'SlLV, 


DotComButt 

DotCom 

GameHelper 

The  game  class,  i 

Makes  DotComs, 
gets  user  input, 
plays  until  all  Dot- 
Corns  are  dead 

The  actual 
DotCom  objects. 
DotComs  know  their 
name,  location,  and 
how  to  check  a user 
guess  for  a match. 

The  helper  class 
(Ready-Bake). 

It  knows  how  to 
accept  user  com- 
mand-JIne  Input, 
and  make  DotCom 
locations. 

5 Objects: 


DotComBust 


GameHelper 


Plus  4 

ArrayLiSts:  1 for 
the  DotComBust 
and  1 for  each 
of  the  3 DotCom 
objects, 
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detailed  structure  of  die  game 


Who  does  what  in  the  PotComPust  game 

(and  when) 


DotComBust 

object 


The  mai'n()  method 
in  the  DotComBust 
class  instantiates  the 
DotComBust  object  that 
does  all  the  game  stuff. 


DotComBust 

object 


The  DotComBust  (game) 
object  instantiates  an 
instance  of  GameHelper, 
the  object  that  will  help 
the  game  do  its  work. 


ArrayUsI  object  (to 
hold  DotCom  objects) 


The  DotComBust  object 
instantiates  an  ArrayUst 
that  will  hold  the  3 DotCom 
objects. 
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prep 


code  Ltost  code  1 


rest  code 


DotComBuit 

GameHelper  helper 
ArrayUst  dotComsUst 
Ini  numOfGueases 


selUpGameQ 

slartPlayingO 

checkUserGuessO 

fintshGameO 


Prep  code  for  the  real  PotComPust  class 


The  DotComBust  class  has  three  main  jobs:  set  up  the  game,  play  the  game 
until  the  DotComs  are  dead,  and  end  the  game.  Although  we  could  map 
those  three  jobs  directly  into  three  methods,  we  split  the  middle  job  (play  the 
game)  into  two  methods,  to  keep  the  granularity  smaller  Smaller  methods 
(meaning  smaller  chunks  of  functionality)  help  us  test,  debug,  and  modify 
the  code  more  easily. 


DECLARE  and  instantiate  the  GameHelper  instance  variable,  named  helper. 


Variable 

Declarations 


DECLARE  and  instantiate  an  AnayUst  to  hold  the  list  of  DotComs  (initially  three)  Call  it 
dotComsUst 

DECLARE  an  int  variable  to  hold  the  number  of  user  guesses  (so  that  we  can  give  the  user  a 
score  at  the  end  of  the  game).  Name  it  numOfGuesses  and  set  it  to  0. 


Method 

Declarations 


DECLARE  a setUpGameQ  method  to  create  and  initialize  the  DotCom  objects  with  names 
and  locations.  Display  brief  instructions  to  the  user. 

DECLARE  a startPlayingO  method  that  asks  the  player  for  guesses  and  calls  the 
checkUserGuessO  method  until  all  the  DotCom  objects  are  removed  from  play. 

DECLARE  a chedcUserGuessfl  method  that  loops  through  all  remaining  DotCom  objects  and 
calls  each  DotCom  object's  checkYourseifO  method. 

DECLARE  a finishGameO  method  that  prints  a message  about  the  user's  performance,  based 
on  how  many  guesses  it  took  to  sink  all  of  the  DotCom  objects. 


Method 

Implementations 


% 
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METHOD:  vo/d  setUpGom*0 

U moke  three  DotCom  objects  and  name  them 
CREATE  three  DotCom  objects. 

SET  a name  for  each  DotCom, 

ADD  the  DotComs  to  the  dotComsUst  ( the  AnrayUst). 

REPEAT  with  each  of  the  DotCom  objects  in  the  dotComsUst  array 

CALL  the  placeDotComQ  method  on  the  helper  object,  to  get  a randomly-selected 
location  for  this  DotCom  (three  cells,  vertically  or  horizontally  aligned,  on  a 7 X 7 grid). 

SET  the  location  for  each  DotCom  based  on  the  result  of  the  placeDotComQ  call, 
END  REPEAT 


END  METHOD 
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Method  Implementations  continued: 

METHOD:  void  startPloylngQ 

REPEAT  while  any  DotComs  exirt 

GET  user  input  by  calling  the  helper  getU&erinputQ  method 
EVALUATE  the  user's  guess  by  checkUserGue$s()  method 
END  REPEAT 
END  METHOD 

METHOD:  void  checkUserGuet$(Strlng  usorGuoss) 

H find  out  if  there's  a hit  (and  kill)  on  any  DotCom 

INCREMENT  the  number  of  user  guesses  in  the  numOfGuesses  variable 

SET  the  local  resuft  variable  (a  String)  to  "miss'1,  assuming  that  the  user's  guess  will  be  a miss, 

REPEAT  with  each  of  the  DotObjects  in  the  dotComsUst  array 

EVALUATE  the  user’s  guess  by  calling  the  DotCom  object's  check  Vburse/fl)  method 
SET  the  result  variable  to  "hrt"  or  "kill”  if  appropriate 
IF  the  resuft  is  "kill",  REMOVE  the  DotCom  from  the  dotComslist 
END  REPEAT 

DISPLAY  the  result  value  to  the  user 
END  METHOD 


METHOD:  void  flnhhGameQ 

DISPLAY  a generic  "game  over”  message,  then: 
I F number  of  user  guesses  is  small, 
DISPLAY  a congratulations  message 

ELSE 

DISPLAY  an  insulting  one 
END  IF 

END  METHOD 


rxj 


rpen  your  pencil 


How  should  we  go  from  prep  code  to  the 
final  code?  First  we  start  with  test  code,  and 
then  test  and  build  up  our  methods  bit  by 
bit.  We  won't  keep  showing  you  test  code 
In  this  book,  so  now  It's  up  to  you  to  think 
about  what  you'd  need  to  know  to  test  these 


methods.  And  which  method  do  you  test 
and  write  first?  See  If  you  can  work  out  some 
prep  code  for  a set  of  tests.  Prep  code  or 
even  bullet  points  are  good  enough  for  this 
exercise,  but  if  you  want  to  try  to  write  the 
real  test  code  (in  Java),  knock  yourself  out. 
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the  DotComBust  code  (the  game) 


prep  code 


import  java . util ; 
public  class  DotComBust  ( 

("private  GameHelper  helper  = new  GameHelper ()  ; 

private  ArrayList<DotCom>  dotComsList  = new  ArrayList<DotCom> () , 
( private  int  nuinOf Guesses  = 0; 

private  void  setUpGame()  { 

//  first  make  some  dot  corns  and  give  them  locations 

DotCom  one  = new  DotCom () ; 

one . setName ("Pets . com" ) ; j 

DotCom  two  = new  DotCom ();  f 

two . setName ("eToys . com” ) ; t 

DotCom  three  = new  DotCom 0;  ( 

three. setName ("Go2 .com") ; \ 

dotComsList . add (one)  ; / 

dotComsList . add (two) ; / 

dotComsList . add (three) ; / 


Annotate  the  code 
youraalft 

Match  the 
annotations  at  the 
bottom  of  each  page 
with  tha  numbers 
In  the  cods.  Writs 
the  number  In  the 
slot  In  front  of  the 
corresponding 
annotation. 

You’ll  use  each 
annotation  Just  ones, 
and  you'll  naod  all  of 
the  annotations. 


System. out  .println  ("Your  goal  is  to  sink  three  dot  corns."); 

System. out . println ("Pets . com,  eToys . com,  Go2 . com") ; ^ 

System. out . println ("Try  to  sink  them  all  in  the  fewest  number  of  guesses"); 

for  (DotCom  dotComToSet  : dotComsList)  ( 

ArrayList<String>  newLocation  =*  helper .placeDotCom(3) ; 
dotComToSet . setLocationCells (newLocation) ; 

) II  close  for  loop 
} / / close  secUpGame  method 

private  void  startPlaying  ()  ( 

while ( ! dotComsList . isEmpty () ) { 

String  userGuess  = helper , getUserlnput ("Enter  a guess"); 
checkUserGuess (userGuess) ; 

) //  close  while 
iinishGame  ()  ; 

) //  close  starcPlaying  method 


, . . i -V \T±  Art  w**- 

vaviaWti  — .tsll  i 


ark  the  kelp*-  f*  a Vok.Cc**  \oLab°» 

rcf&i  vui-th  t&ck  DolCo*"  i*  ^ 


WifrP  Jive  i£  loiiiion  v*  w 

irvjWtioni  kdr  hefpo-  ^ $>i 

,u\\  ou*-  own  -finiiMjar*<  mtikdd  e" 


as  l 0*3  as  the  DotCc 
" list  is  WOT  emfby 
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private  void  checkUserGuess  (String  userGuess)  { 

numOfGuesses++; 

String  result  = "miss"; 

for  (DotCom  dotComToTest  : dotComsList)  { 

result  = dotComToTest . checkYourself (userGuess) ; 
if  (result . equals ("hit")  ) { 

break; 

if  (result. equals ("kill") ) { 

dotComsList . remove (dotComToTest) ; 
break; 

} 

} //  close  for 

System,  out  .println  (result)  ; fill 

} //  close  method 


Whatever  you  do, 
DON’T  turn  the 
page! 

Not  until  you’ve 
finished  this 
exercise. 

Our  version  is  on 
the  next  page. 


private  void  finishGaxne  ()  { 

System. out .println ("All  Dot  Corns  are  dead!  Your  stock  is  now  worthless." 
if  (numOfGuesses  <=  18)  { 

System. out .println ("It  only  took  you  " + numOfGuesses  + " guesses."); 
System. out .println ("  You  got  out  before  your  options  sank."); 

} else  { 

System. out .println ("Took  you  long  enough.  "+  numOfGuesses  + " guesses 
System. out .println ("Fish  are  dancing  with  your  options."); 

} 

} //  close  method 


public  static  void  XQain  (String []  args)  { 
DotComBust  game  = new  DotComBust ( ) ; 
game . setUpGame ( ) ; ^ 

game. startPlaying () ; 

} //  close  method 


. Pto  * message  telling  the 
««■  How  he  did  in  -the  game 


pHht  tbe 

result  £>r 
the  user 


_vefeat  *ith  all  PotComs  in  the  list 

_ this  Ws  dead,  so  take  him  out  of  the 
PotComs  list  then  get  out  of  the  loop 

^ , w,  j,.  Ma  *— 

~Setortrftt«u,  Ik,  - 11,1  Ml  in  ^ S“”' 

tKe  others  3 the  4ue«;  Create  the  t\a*e  oh\tti 


tell  the  ga»e  object 

to  set  up  the 
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the  DotComBust  code  (the  game) 
prep  code  last  code 


import  java. util.*; 
public  class  DotComBust  { 


private  GameHelper  helper  - new  GameHelper ()  ; 
private  ArrayList<DotCom>  dotComsList  = new  ArrayList<DotCom> () ; Mak< 
private  int  numOfGuesses  = 0; 


private  void  settfpGame  ( ) { 

II  first  make  some  dot  corns  and  give  them  locations 
DotCom  one  = new  DotComO; 
one .setName ("Pets .com") ; 

DotCom  two  = new  DotComO; 
two . setName ("eToys . com" ) ; 

DotCom  three  = new  DotComO; 
three . setName ("Go2 . com") ; 
dotComsList . add (one) ; 
dotComsList . add (two) ; 
dotComsList . add (three) ; 


Make 

the  Awa'/Lilt 


vjords.  a Visl  tiol  ^ 

okilV  P otCo."  , i 

jwt  as  PoKVC  v, 
tea«  an  *«*l  DoK 
obje*W- 


in 


Print  bv'ic-f 
inS-trudtionJ  -for 


System . out .println ("Your  goal  is  to  sink  three  dot  corns."); 

System. out .pr inti n ("Pets . com,  eToys.com,  Go2 . com") ; 

System. out . println ("Try  to  sink  them  all  in  the  fewest  number  of  guesses"); 

for  (DotCom  dotComToSet  ; dotComsList)  { ^ vii’th  t&th  DotCom  ,fk  the 

/isk  {hr  (or  d 

ArrayList<String>  newLocation  = helper. placeDotCom (3)  ; ^ * DotCo** 

of  $W>- 


dotComToSet . setLocationCells (newLocation) ; 


) //  close  for  loop 
) //  close  sotLTpgame  method 


private  void  startPlaying ()  ( „ 

while  ( ! dotComsList.  isEmpty  0 ) {4r  ^ s3r*t  3s 

String  userGuess  = helper  .getUser  Input  ("Enter  a guess")  ; us<v* 

checkUserGuess (userGuess) ; ^ 

) //  close  while  w 

finishGame  ()  ; ^ ouv-  own  methad. 

) U close  star tPlaying  method 
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private  void  checkUserGuesS  (String  userGuess)  { 

numOfGuesses++;  ^ tKc  number  of  3»*esscs  the  *sev  Kas  made 

String  result  = "miss";  * assume  it’s  a lm»ss , unless  bold  otherwise 

for  (DotCom  dotComToTest  : dotComsList)  { ( -*  defeat  all  DotComs  m t 


String  result  = "miss"; 


for  (DotCom  dotComToTest  : dotComsList)  { 


result  ^ dotComToTest . checkYourself (userGuess); 


if  (result. equals ("hit") ) { 


ask  the  PotCr  to  ehtfk  the  «er 
guess,  looking  for  a hit  lor  kilU 


A- — the  loop  early,  no  point 

m testing  the  others 


if  (result .equals  ("kill"')  ) { 

dotComsList . remove (dotComToTest) ; 
break; 


this  guy's  dead,  so  take  hi*  out  of  the 
VoiComs  list  then  get  out  of  the  loop 


} //  close  for 

System. out .println (result) ; result  for  the 

} //  close  method 


private  void  finxshGante  ( ) { 

System. out .println ("All  Dot  Corns  are  dead!  Your  stock  is  now  worthless .")  ,*\ 
if  (numOfGuesses  <=  18)  { l 

System. out .println ("It  only  took  you  " + numOfGuesses  + " guesses.");  V 
System. out .println ("  You  got  out  before  your  options  sank."); 

} else  { 

System. out .println ("Took  you  long  enough.  "+  numOfGuesses  + " guesses,"); 
System. out .println ("Fish  are  dancing  with  your  options"); 

} 

} //  close  method 


public  static  void  main  (String []  args)  { 
DotComBust  game  = new  DotComBust ( ) ; { — 

game . setUpGame ( ) ; 

game . startPlaying ( ) ; y 

} //  close  method  ^ 


J**'  Imt  rjLj  tke 
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the  DotCom  code 


The  final  version  of  the 
PotCom  class 


import  java. util.*; 


public  class  DotCom  { 

private  ArrayList<String>  locationCells ; 
private  String  name; 


PotCom's  instance  variables: 

- an  Arv-ayUst  of  tell  locations 

- the  PotCom's  na»e 


public  void  setLocationCells  (ArrayList<String>  loc)  { 
locationCells  = loc; 


} 


A setter  method  that  updates 
the  PotCom’s  location. 

(Random  location  yrovided  by 
the  ^amettelper  placePotComl  ) 
method.) 


/our  basic  setter  method 


public  void  setName  (String  n)^4- 
name  = n; 

} The  ArrayL-ist  indenOf  ( > method  in 

action!  It  the  user  guess  is  one  o+  the 
entries  in  the  ArrayList,  ndenOfi 

public  String  checkYourself  (String  userlnput)  { wll  vc*tuv»\  *rb  /WrayList 

String  result  = "miss";  not,  inde*0#  ) vuill  return  -I • 

int  index  = locationCells . indexOf (userlnput) ; 

if  (index  > 0)  { ^ Us'mj  /Wray  Lis  Vs  vemove(  ) mciHod  -fco  At\  ewfary* 


locationCells . remove (index) ; 


if  (locationCells . isEmpty {) ) { ^ 

result  = "kill"; 


Using  the  is£m ?t/  > method  to  see  if  all 
of  the  locations  have  been  guessed 


System. out .println ("Ouch ! You  sunk  " + name  + " : ( ") ; 

} else  { 


result  - "hit"; 
} //  close  if 

} //  close  if 
return  result; 

} / / close  method 
} //  close  class 


Tell  the 


“"“fc“aP«tC«,la!be„ 


fcW  miss'  or  ‘hit'  or  'kill'. 
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Super  Powerful  Boolean  Expressions 

So  far,  when  we've  used  boolean  expressions  for  our  loops  or 
if  tests, they've  been  pretty  simple.  We  will  be  using  more 
powerful  boolean  expressions  in  some  of  the  Ready-Bake  code 
you're  about  to  see,  and  even  though  we  know  you  wouldn't 
peek,  we  thought  this  would  be  a good  time  to  discuss  how  to 
energize  your  expressions. 

‘And’  and  ‘Or*  Operators  ( &&,  ||  ) 

Let's  say  you're  writing  a chooseCamera( ) method,  with  lots  of  rules 
about  which  camera  to  select.  Maybe  you  can  choose  cameras 
ranging  from  $50  to  $1 000,  but  in  some  cases  you  want  to  limit  the 
price  range  more  precisely.  You  want  to  say  something  like: 

'If  the  price  range  is  between  $300  and  $400  then  choose  X.' 

if  (price  >=  300  &&  price  < 400)  { 
camera  ■ "X"; 

> 

Let's  say  that  of  the  ten  camera  brands  available,  you  have  some 
logic  that  applies  to  only  a few  of  the  list: 

if  (brand. equals ("A")  ||  brand. equals ("B")  ) { 
//do  stuff  for  only  brand  A or  brand  B 

} 

Boolean  expressions  can  get  really  big  and  complicated: 

if  ( (zoomType. equals ("optical")  && 

(zoomOegree  >■  3 &&  zoomDegree  <=  8))  | | 
(zoomType. equals ("digital")  & 6 
(zoomOegree  >=  5 &&  zoomOegree  <■  12)))  { 
//do  appropriate  zoom  stuff 

} 

If  you  want  to  get  really  technical,  you  might  wonder  about  the 
precedence  of  these  operators.  Instead  of  becoming  an  expert 
in  the  arcane  world  of  precedence,  we  recommend  that  you  use 
parentheses  to  make  your  code  clear. 


Not  equals  ( is  and  I ) 

Let's  say  that  you  have  a logic  like, “of  the  ten  available 
camera  models,  a certain  thing  is  true  for  all  but  one." 

if  (model  1=  2000)  { 

//  do  non-model  2000  stuff 

} 

or  for  comparing  objects  like  strings... 

if  ( 1 brand. equals ("X") ) { 

//do  non-brand  X stuff 

} 

Short  Circuit  Operators  ( &&  , || ) 

The  operators  we've  looked  at  so  far,  &&  and  ||,  are 
known  as  short  circuit  operators.  In  the  case  of  &&, 
the  expression  will  be  true  only  if  both  sides  of  the  && 
are  true.  So  if  the  JVM  sees  that  the  left  side  of  a && 
expression  is  false,  it  stops  right  there!  Doesn't  even 
bother  to  look  at  the  right  side. 

Similarly,  with  ||,the  expression  will  be  true  if  either  side  is 
true,  so  if  the  JVM  sees  that  the  left  side  is  true,  it  declares 
the  entire  statement  to  be  true  and  doesn't  bother  to 
check  the  right  side. 

Why  is  this  great?  Let's  say  that  you  have  a reference 
variable  and  you're  not  sure  whether  it's  been  assigned 
to  an  object.  If  you  try  to  call  a method  using  this  null 
reference  variable  (i.e.  no  object  has  been  assigned),  you'll 
get  a NullPointerException.  So,  try  this: 

if  (refVar  1=  null  && 

refVar.isValidTypeQ  ) { 

//  do  'got  a valid  type'  stuff 

} 

Non  Short  Circuit  Operators  ( & , | ) 

When  used  in  boolean  expressions,  the  & and  | operators 
act  like  their  &&  and  ||  counterparts,  except  that 
they  force  the  JVM  to  always  check  both  sides  of  the 
expression.  Typically, & and  | are  used  in  another  context, 
for  manipulating  bits. 


you  are  here  ► 151 


Ready-bake:  GameHelper 


^^Readj-fcake 


import  java.io.*; 
import  java. util.*; 


This  is  the  helper  class  for  the  game.  Besides  the  user  input  method 
(that  prompts  the  user  and  reads  input  from  the  command-line),  the 
helper's  Big  Service  is  to  create  the  cell  locations  for  the  DotComs. 
If  we  were  you,  wed  just  back  away  slowly  from  this  code,  except 
to  type  it  in  and  compile  it.  We  tried  to  keep  it  fairly  small  to  you 
wouldn't  have  to  type  so  much,  but  that  means  it  isn't  the  most 
readable  code.  And  remember,  you  won't  be  able  to  compile  the 
DotComBust  game  class  until  you  have  this  class. 


public  class  GameHelper  { 

private  static  final  String  alphabet  - "abcdefg" ; 

private  int  gridLength  = 7; 

private  int  gridSize  - 49; 

private  int  {]  grid  = new  int [gridSize] ; 

private  int  comCount  - 0; 

public  String  getUserlnput (String  prompt)  { 
String  inputLine  = null; 

System. out. print (prompt  + " "); 

try  { 

Buf feredReader  is  = new  Buf feredReader ( 
new  InputStreamReader (System. in) ) ; 
inputLine  = is . readLine 0 ; 

if  (inputLine . length ( ) ==  0 ) return  null; 
) catch  (lOException  e)  { 

System. out . println ("lOException : " + e)  ; 

) 

return  inputLine . toLowerCase 0 ; 


Por  cv-tra  trtd it*  yau  ■higk't 
■try  fkt 

£ys^m.<>u-kprih'fc(U),s  i*  ike 
plafeDotCo^C  ) method*  juit 
to  wati-h  it  work)  Th^^c  print 
iiatewienii  will  let  you  ‘Vhcat*1 
lay  yo*  the  location  of  tk« 

DotComij  but  it  will  kdp  you  t«t  it 


public  ArrayList<String>  placeDotCom (int  comSize)  ( 

ArrayList<String>  alphaCells  = new  ArrayList<String> ( ) ; 


String  []  alphacoords  = new  String  [comSize 1;  // 
String  temp  = null;  // 
int  [)  coords  = new  int [comSize] ; // 
int  attempts  = 0;  // 
boolean  success  = false;  // 
int  location  = 0;  // 


holds  'f6'  type  coords 
temporary  String  for  concat 
current  candidate  coords 
current  attempts  counter 
flag  = found  a good  location 
current  starting  location 


comCount++; 
int  incr  = 1; 

if  ((comCount  % 2)  ==1)  [ 
incr  = gridLength; 

) 


//  nth  dot  com  to  place 

//  set  horizontal  increment 

//  if  odd  dot  com  (place  vertically) 

/ / set  vertical  increment 


while  ( [success  & attempts++  < 200  ) f 

location  = (int)  (Math . random ( ) * gridSize); 

//System. ouc . print ( " try  " + location) ; 
int  x - 0; 
success  = true; 

while  (success  &&  x < comSize)  { 
if  (grid [ location]  --  0)  { 


//  main  search  loop  (32) 

//  get  random  starting  point 

//  nth  position  in  dotcom  to  place 
//  assume  success 
//  look  for  adjacent  unused  spots 
//  if  not  already  used 
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SReadf'fcake  ♦ameHelper  class  code  continued 

Cade 


} 


} 


coords [x++]  = location; 
location  +=  incr; 
if  (location  >=  gridSize) { 
success  - false; 

} 

if  (x>0  &&  (location  % gridLength  ==  0))  { 

success  = false; 

} 

} else  { 

//  System. out .print ("  used  " + location) ; 
success  = false; 


//  save  location 

/ / try  'next'  adjacent 

//  out  of  bounds  - 'bottom' 

//  failure 

//  out  of  bounds  - right  edge 
//  failure 

//  found  already  used  location 
//  failure 


//  end  while 


int  x = 0; 
int  row  = 0; 
int  column  = 0; 

//  Sy stem . out . pr intin ("\n") ; 
while  (x  < comSize)  { 
grid [coords [xj ] = 1; 

row  = (int)  (coords [x]  / gridLength); 

column  - coords [x]  % gridLength; 

temp  = String. valueOf (alphabet . charAt (column)); 


//  turn  location  into  alpha  coords 


//  mark  master  grid  pts.  as  'used' 
//  get  row  value 
//  get  numeric  column  value 
//  convert  to  alpha 


alphaCells . add (temp . concat (Integer . toString (row) ) ) ; 
x++; 

//  System,  out  .print  (n  coord  "+x+"  - 11  + alphaCells . get  (x-1 ) ) 


//  System . out . println  (" \n") ; 


return  alphaCells; 

} 

} 
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API  packages 


Using  the  Library  (the  Java  API) 

You  made  it  all  the  way  through  the  DotComBust  game, 
thanks  to  the  help  of  ArrayUst.  And  now,  as  promised, 
it's  time  to  learn  how  to  fool  around  in  the  Java  library. 


To  use  a class  in  the  API,  you 
have  to  know  which  package 
the  class  Is  in. 


Every  class  in  the  Java  library  belongs  to  a package. 
The  package  has  a name,  like  javax. swing  (a 
package  that  holds  some  of  the  Swing  GUI  classes 
you'll  learn  about  soon) . ArrayList  is  in  the  package 
called  java. Util,  which  surprise  surprise,  holds  a 
pile  of  utility  classes.  You’ll  learn  a lot  more  about 
packages  in  chapter  16,  including  how  to  put  your 
oum  classes  into  your  (rum  packages.  For  now  though, 
we’re  just  looking  to  use  some  of  the  classes  that  come 
with  Java. 

Using  a class  from  the  API,  in  your  own  code,  is 
simple.  You  just  treat  the  class  as  though  you  wrote 
it  yourself...  as  though  you  compiled  it,  and  there  it 
sits,  waiting  for  you  to  use  it.  With  one  big  difference: 
somewhere  in  your  code  you  have  to  indicate  the  full 
name  of  the  library  class  you  want  to  use,  and  that 
means  package  name  + class  name. 

Even  if  you  didn't  know  it,  you  *ve  already  been  using 
classes  from  a package.  System  (System.out-println), 
String,  and  Math  (Math.randomO),  all  belong  to  the 
javadang  package. 
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You  have  to  know  the  full  name* 
of  the  class  you  want  to  use  in 
your  code. 


ArrayList  is  not  the  full  name  of  ArrayList,  just  as  ‘Kathy’ 
isn’t  a full  name  (unless  it’s  like  Madonna  or  Cher,  but  we 
won’t  go  there).  The  full  name  of  ArrayList  is  actually: 


java . util .ArrayList 


Why  does  there  have  to 
be  a full  name?  Is  that  the  only 
purpose  of  a package? 

A. 

Packages  are  important 
for  three  main  reasons.  First,  they 
help  the  overall  organization  of  a 
project  or  library.  Rather  than  just 
having  one  horrendously  large 
pile  of  classes,  they're  all  grouped 
into  packages  for  specific  kinds 
of  functionality  (like  GUI,  or  data 
structures,  or  database  stuff,  etc.) 


You  have  to  tell  Java  which  ArrayList  you 
want  to  use.  You  have  two  options: 


Q IMPORT 

Put  an  import  statement  at  the  top  of  your  source  code  file: 

import  java. util .ArrayList; 
public  class  MyClass  { . . . } 


Second,  packages  give  you  a name- 
scoping, to  help  prevent  collisions 
if  you  and  12  other  programmers 
in  your  company  all  decide  to 
make  a class  with  the  same  name. 

If  you  have  a class  named  Set  and 
someone  else  (including  the  Java 
API)  has  a class  named  Set, you 
need  some  way  to  tell  the  JVM 
which  Set  class  you're  trying  to  use. 


OR 


Q TYPE 

Type  the  full  name  everywhere  in  your  code.  Each  time 
you  use  it.  Anywhere  you  use  it. 


When  you  declare  and/or  instantiate  it: 

java. util. ArrayList<Dog>  list  = new  java. util. ArrayList<Dog>(); 


Third,  packages  provide  a level  of 
security,  because  you  can  restrict 
the  code  you  write  so  that  only 
other  classes  in  the  same  package 
can  access  it. You'll  learn  all  about 
that  in  chapter  16. 

^L*OK,  back  to  the  name 
collision  thing.  How  does  a full 
name  really  help?  What's  to 
prevent  two  people  from  giving  a 
class  the  same  package  name? 


When  you  use  it  as  an  argument  type: 

public  void  go  (java,  util . ArrayList<Dog>  list) 


When  you  use  it  as  a return  type: 

public  java. util. ArrayList<Dog>  foo()  { . . . ) 


-^V-Java  has  a naming  convention 
that  usually  prevents  this  from 
happening,  as  long  as  developers 
adhere  to  it.  We'll  get  into  that  in 
more  detail  in  chapter  16. 


‘Unless  the  class  is  in  the  java. lang  package. 
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Where’d  that  V come  from? 

(or,  what  does  it  mean  when 
a package  starts  with  Javax?) 

In  the  first  and  second  versions  of  Java  (1.02 
and  1.1),  all  classes  that  shipped  with  Java  (In 
other  words,  the  standard  library)  were  In  packages 
that  began  with  Java.  There  was  always  Java  Jang,  of  course 
— the  one  you  don't  have  to  import.  And  there  was  Java.net, 
Java  Jo,  Java. util  {although  there  was  no  such  thing  as  ArrayLlst 
way  back  then),  and  a few  others,  Including  the  java.awt 
package  that  held  GUI-related  classes. 

Looming  on  the  horizon,  though,  were  other  packages  not 
included  in  the  standard  library. These  classes  were  known  as 
ex tensions,  and  came  in  two  main  flavors:  standard,  and  not 
standard.  Standard  extensions  were  those  that  Sun  considered 
official,  as  opposed  to  experimental,  early  access,  or  beta 
packages  that  might  or  might  not  ever  see  the  light  of  day 

Standard  extensions,  by  convention,  all  began  with  an  V 
appended  to  the  regular  Java  package  starter.  The  mother  of  all 
standard  extensions  was  the  Swing  library  It  Included  several 
packages,  all  of  which  began  with  javax^swlng. 

But  standard  extensions  can  get  promoted  to  first-class,  ships- 
with-Java,  standard-out-of-the-box  library  packages.  And  that's 
what  happened  to  Swing,  beginning  with  version  1 .2  (which 
eventually  became  the  first  version  dubbed  Java  21 

"Cool"  everyone  thought  (Including  us)."Now  everyone  who  has 
Java  will  have  the  Swing  classes,  and  we  won't  have  to  figure 
out  how  to  get  those  classes  installed  with  our  end-users." 

Trouble  was  lurking  beneath  the  surface,  however,  because 
when  packages  get  promoted,  well  of  COURSE  they  have  to 
start  with  Java,  not  Javax.  Everyone  KNOWS  that  packages  In 
the  standard  library  don't  have  that  "X? and  that  only  extensions 
have  the"x*  So, Just  (and  we  mean  just)  before  version  1.2 
went  final,  Sun  changed  the  package  names  and  deleted  the 
"x’{among  other  changes).  Books  were  printed  and  in  stores 
featuring  Swing  code  with  the  new  names.  Naming  conventions 
were  intact.  All  was  right  with  the  Java  world. 

Except  the  20,000  or  so  screaming  developers  who  realized 
that  with  that  simple  name  change  came  disaster!  All  of  their 
Swing-using  code  had  to  be  changedl  The  horror!  Think  of  all 
those  Import  statements  that  started  withyavax... 

And  In  the  final  hour,  desperate,  as  their  hopes  grew  thin,  the 
developers  convinced  Sun  to  "screw  the  convention,  save  our 
code"  The  rest  Is  history.  So  when  you  see  a package  in  the 
library  that  begins  with  Javax,  you  know  It  started  life  as  an 
extension,  and  then  got  a promotion. 


BULLET  POINTS^* 

■ ArrayList  is  a class  in  the  Java  API . 

■ To  put  something  Into  an  ArrayList,  use  add(). 

■ To  remove  something  from  an  ArrayList  use 

removeO* 

■ To  find  out  where  something  is  (and  if  it  is)  in  an 
ArrayList,  use  indexOfQ. 

■ To  find  out  if  an  ArrayList  is  empty,  use 

isEmptyO. 

■ To  get  the  size  (number  of  elements)  in  an 
ArrayList,  use  the  stzeO  method. 

■ To  get  the  length  (number  of  elements)  in  a 
regular  old  array,  remember,  you  use  the  length 

variable. 

■ An  ArrayList  resizes  dynamically  to  what* 
ever  size  is  needed.  It  grows  when  objects 
are  added,  and  it  shrinks  when  objects  are 
removed. 

■ You  declare  the  type  of  the  array  using  a type 
parameter,  which  is  a type  name  in  angle 
brackets,  Example:  ArrayList<8utton>  means 
the  ArrayList  will  be  able  to  hold  only  objects  of 
type  Button  (or  subclasses  of  Button  as  you’ll 
leam  in  the  next  couple  of  chapters). 

■ Although  an  ArrayList  holds  objects  and  not 
primitives,  the  compiler  will  automatically  "wrap’ 
(and  ‘unwrap’  when  you  take  It  out)  a primi- 
tive into  an  Object  and  place  that  object  In  the 
ArrayList  Instead  of  the  primitive.  (More  on  this 
feature  later  in  the  book.) 

■ Classes  are  grouped  into  packages. 

■ A dass  has  a full  name,  which  is  a combina- 
tion of  the  package  name  and  the  class  name. 
Class  ArrayList  is  really  Java.util  ArrayList. 

■ To  use  a class  in  a package  other  than  java, 
lang,  you  must  tell  Java  the  full  name  of  the 
dass. 

■ You  use  either  an  Import  statement  at  the  top  of  , 
your  source  code,  or  you  can  type  the  full  name 
every  place  you  use  the  dass  in  your  code. 
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Dto^sffons 


K^s  Does  import  make  my 
class  bigger?  Does  It  actually 
compile  the  imported  class  or 
package  Into  my  code? 

J^Z  Perhaps  you're  a C pro- 
grammer? An  import  is  not  the 
same  as  an  include.  So  the 
answer  is  no  and  no.  Repeat  after 
me:"an  import  statement  saves 
you  from  typing. "That's  really  It. 
You  don't  have  to  worry  about 
your  code  becoming  bloated  or 
slower, from  too  many  Imports. 

An  import  is  simply  the  way  you 
give  Java  the  full  name  of  a class . 


OK/  how  come  I never  had 
to  Import  the  String  class?  Or 
System? 

^Z  Remember,  you  get  the 
java.lang  package  sort  of  wpre- 
Imported"  for  free.  Because 
the  classes  In  java.lang  are  so 
fundamental, you  don't  have  to 
use  the  full  name. There  Is  only 
one  java Jang.Strlng  class,  and  one 
java.iang.System  class, and  Java 
darn  well  knows  where  to  find 
them. 


Q?  Do  I have  to  put  my  own 
classes  Into  packages?  How  do  1 
do  that?  Can  1 do  that? 


j^Z  In  the  real  world  (which 
you  should  try  to  avoid),  yes,  you 
will  want  to  put  your  classes  Into 
packages.  We'll  get  into  that  in 
detail  In  chapter  \ 6.  For  now,  we 
won't  put  our  code  examples  In  a 
package. 


***  * Siiekl 

toses  are  red, 
aPl ties  are  ripe, 
if you  don't  fmp0rt 
y°»'"JusthaVetotype 

You  must  tell  jaVa 

you  use,  unless  that  ri  JU  "ame  of  every  class 

opac*r-  a"  4o  rf«sa;:<nthe^-4 

or  Parage  at  the  ton  JT  m for  th«  class 

®3Sy  Way- Otherwise  you  h0lJrS0Urce  cod«  « the 


use  it! 


One  more  time,  in  the  unlikely 
event  that  you  don’t  already 
have  this  down: 
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How  to  play  with  the  API 

Two  things  you  want  to  know: 

Q What  classes  are  In  the  library? 

A Once  you  find  a class,  how  do 
you  know  what  it  can  do? 

Browse  a Book 


“ Good  to  know  there’s  an  Army  List  in 
the  java.util package.  But  by  myself,  how 
would  1 have  figured  that  out?” 

- Julia,  31,  hand  model 


Cs  L'  r. 


Oaettd 


Use  the  HTML  API  docs 


flwrrt twfrM  J HManrn  U 


JAVA 


i IX  A NUTSHELL 


A Desktop  Quick  Reference 


O REILLY 
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Browse  a Book 


JAVA 


Flipping  through  a 
reference  book  is  the 
best  way  to  find  out 
what’s  in  the  Java 
library,  you  can  easily 
stumble  on  a class  that 
looks  useful,  just  by 
browsing  pages. 


java . util . Currency 

Rtrurrwd  Syr  Jofr .teiLDedmfllfiyniatS^ 

jas^t^Numbcff^muiL^Cuii^cyf).  CDnancy.getiftstanc^ 


package  name 
asi  dest'r'V^0’' 


S dcnt&bk)  senate aWu  ottmpaabh 

This  class  represents  dales  and  limes  and  lets  you  work  wiita  them  m a system-mdepco- 
deni  way.  You  can  creaic  a Date  by  specifying  the  number  of  mlQisecond*  from  the 
epoch  (midnight  GAIT,  January  1st.  1970)  or  the  year,  month,  date,  and,  optionally,  the 
hour,  minute,  and  second.  Years  arc  specified  as  the  number  of  years  since  1900,  If  you 
call  the  Date  constructor  with  no  arguments.  the  Dale  is  initialized  to  ihc  current  lime 
and  dale.  The  instance  methods  of  the  class  allow  you  to  get  and  set  the  various  date 
and  Heir  fields,  to  compare  dales  and  limes,  and  to  convert  dales  to  and  from  string 
representations.  As  of  Java  I I,  many  of  the  dale  methods  have  been  deprecated  in 
favor  of  the  methods  of  the  Calendar  dass. 


^hd  ttb* 


pubfccdaa  Data  inpieftwfeidttie^te,  CwpalM,  Serial  uafck  ( 

//PfibQzCw tfm&s 

P^cbttoO; 
puttie  D*t*(ioft<tisat): 
i pubncO*tKStrir«<li 
» public  year,  i in  monO),  lot  (tore): 

9 puttie  Pittfmt  jnsar,  Int  ranfl.  in  dtote,  iM  fos.  mtmli); 

# puttie  Patofmt  year,  int  month,  int  d!»fie.  int  /irs.  Int  mi),  itt  sec\: 
//PmprtrAct&w  m Ms  fapfopKiymm) 

puttie  long 

piflltwld  M(TlM(lef^ttne); 

//Pvbktotf^mot* 
puttie  boolean  *ft*rtfarajjtii.Bate  when): 
puttie  Mew  befaifijra.i/tt  Data  vto): 
u puttie  inteoMpBMlbQwuin'.Dtte  no&rOati): 

//ItotoaH  lm$  ml  Qmm& 
u puttie  Int  comp*  raTo  (Object  oj; 

//pm  umhOM&vow 

IJ  puttie  Object  d0M(); 
p^icbo<^«|DBi(0ttKiott|: 
puttic  Int  tehfediO: 
puttie  5tnnfte^tttogO;. 

//  Depneea  fed  A/Pfc  UvMt 

a puttie  int  »©«•<), 

# puttie  Int  ftffryO: 

p puttie  int  ptHooaO; 

# puttie  int  f^MhiotMO: 
t puttie  int 

I puttie  Int  fatSacoBdsQ: 

9 puttie  Int 
$ puttie  int  pflbatO: 

I puttie  long  fc»w#($Mnfcjl; 

« pttyicvokl  s*tDart*(im  dito); 
t puttied  e#tHou»(*rtA«<a): 
r puttlcvo  * ' - states); 

9 puttie  wid**tMurt(lnt/nonA); 
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using  the  Java  API  documentation 


Use  the  HTML  API  docs 

Java  comes  with  a fabulous  set  of  online  docs 
called,  strangely,  the  Java  API.  They’re  part  of 
a larger  set  called  the  Java  5 Standard  Edition 
Documentation  (which,  depending  on  what 
day  of  the  week  you  look,  Sun  may  be  refer- 
ring to  as  aJava  2 Standard  Edition  5.0*),  and 
you  have  to  download  the  docs  separately; 
they  don’t  come  shrink-wrapped  with  the  Java 
5 download.  If  you  have  a high-speed  internet 
connection,  or  tons  of  patience,  you  can  also 
browse  them  atjava.sun.com.  Trust  us,  you 
probably  want  these  on  your  hard  drive. 

The  API  docs  are  the  best  reference  for  get- 
ting more  details  about  a class  and  its  methods. 
Let  s say  you  were  browsing  through  the  refer- 
ence book  and  found  a class  called  Calendar, 
in  java.util.  The  book  tells  you  a little  about  it, 
enough  to  know  that  this  is  indeed  what  you 
want  to  use,  but  you  still  need  to  know  more 
about  the  methods. 


The  reference  book,  for  example,  tells  you 
what  the  methods  take,  as  arguments,  and  what 
they  return.  Look  at  ArrayList,  for  example. 

In  the  reference  book,  you’ll  find  the  method 
indexOf(),  that  we  used  in  the  DotCom  class. 
But  if  all  you  knew  is  that  there  is  a method 
called  indexOf()  that  takes  an  object  and  re- 
turns the  index  (an  int)  of  that  object,  you  still 
need  to  know  one  crucial  thing:  what  happens 
if  the  object  is  not  in  the  ArrayList?  Looking 
at  the  method  signature  alone  won’t  tell  you 
how  that  works.  But  the  API  docs  will  (most  of 
the  time,  anyway).  The  API  docs  tell  you  that 
the  indexOf()  method  returns  a -I  if  the  object 
parameter  is  not  in  the  ArrayList.  That’s  how 
we  knew  we  could  use  it  both  as  a way  to  check 
if  an  object  is  even  in  the  ArrayList,  and  to  get 
its  index  at  the  same  time,  if  the  object  was 
there.  But  without  the  API  docs,  we  might  have 
thought  that  the  indexOf()  method  would 
blow  up  if  the  object  wasn’t  in  the  ArrayList. 


fd  UWtk  -,v  < 

*•  to.  lirt  k / 

[flva.sqt  f 

laya-tert  L, 

lavamm  P 

lavfl.uill.ooflfl/rrBm 
tavn  uttlcooeurrcim.au 

JfiYfl.uni,WftcurrPfTifo^ 

lava,  urii,  tar  L 

tava.mi)JoOTipq 
(jftj nw*  r— L 

® a.  \Vt  \ 

\ 

^ *va"e' 

fltMftf  p 

SB!  I 

g L 

SoctertSet  ■ 

Classes 

AtTClfflCtCoStCfrOfl 

AMlraflUst 

AMiranMflo 
Manr*flQittua  r 

ADsiractSMiwuaftJii 

Arrayli&t 

Mm 

anSfti  r 

Calendar 

OotocttonH  1 

Currency 

om 

Ptetbnarv 

/ 

Construct*  in  empty  bit  with  in  tnhiil  capacity  ot 

[jjrriiUit (gftlUaUflft* ? «x*fwu  £>  a) 

Construct*  1 list  containing  the  dement*  of  the  spot  ^ 
| returned  by  the  oofectfofl**  iterator 

I AjttUbH -Ln*  icdtJL»lC*sk*oity  1 

Constructs  an  empty  Lba  with  the  specified  initial  op 


«k(K  o) 

Appeals  the  specified  element  ioiht  end  of 


lad**,  E iltBaDt} 

Insert*  ihe  specified  element  a ibe  spoofed 


y*  ***  , L ' 


a4Alkn<CftUtcUcm<r 

Append*  ill  of  the  elements  In  the  fpcdfltd  Collection  to  the  end  of  Ms  list,  in 
the  Offer  d ui  they  ate  returned  by  the  specified  CoOecaoc's  Iterator 


Lode*,  Coiiaotloa-*?  -ott-tid*  £>  o\ 

Insert*  all  of  the  dement*  in  the  spodfed  Collection  Into  this  Urt,  starting  at  (he 
cncctfed  rwKlrinn 
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Code  Magnets 


Can  you  reconstruct  the  code  snippets  to  make  a 
working  Java  program  that  produces  the  output 
listed  below?  NOTE: To  do  this  exercise,  you  need 
one  NEW  piece  of  info — If  you  look  in  the  API  for 
ArrayList,  youTI  find  a second  add  method  that  takes 
two  arguments: 

add(lnt  Index,  Object  o) 

It  lets  you  specify  to  the 
ArrayList  where  to  put  the  object  you're  adding. 


I Fite  Edit  Window  Help  Daises 


& j ava 

ArrayLisfeMagnet 

zero 

one 

two 

three 

zero 

one 

three 

four 

zero 

one 

three 

four 

4.2 

2ero 

one 

three 

four 

4.2 
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puzzle:  crossword 


Ja&aCreSS  7.0 


How  does  this  crossword  puzzle  help  you  leam 
Java?  Well,  all  of  the  words  are  Java  related 
(except  one  red  herring). 

Hint;  When  In  doubt  remember  ArrayUst 


Across 

1 . 1 can't  behave 

6.  Or,  In  the  courtroom 

7.  Where  It's  at  baby 

9.  A fork's  origin 

12.  Grow  an  ArrayUst 

13.  Wholly  massive 

14.  Value  copy 

16.  Not  an  object 

1 7.  An  array  on  steroids 

1 9.  Extent 

21.  counterpart 

22.  Spanish  geek  snacks  (Note;  This  has 
nothing  to  do  with  Java.) 

23.  For  lazy  fingers 

24.  Where  packages  roam 


Down 

2.  Where  the  Java  action  is. 

3.  Addressable  unit 

4.  2nd  smallest 

5.  Fractional  default 

8.  Library's  grandest 

10.  Must  be  low  density 

1 1.  He's  In  there  somewhere 

15.  As  If 

1 6.  dearth  method 

18.  What  shopping  and  arrays  have  in  common 

20,  Library  acronym 

21.  What  goes  around 


More  Hints: 

e 6up|euj  5J3iiiaddcL|S|UPd5-EAcnnoqciON  n 

VSnXexi v siuiqj.  *9 1 lu  3ixa  s,Aslu v ' l Z 

‘01  V > 3Ai^u>Md  udojuj<o  *9L 

Jiwiu  IsnAcuy  1 

HqeptjjaAO  s,w*M  Z safjajiEA  q ■ 1 

omoo  «oj^v 
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puzzle  answers 


your  pencil 


Across 


Write  your  OWN  set  of  clues!  Look  at  each  word,  and  try  to 
write  your  own  clues.Try  making  them  easier,or  harder,  or 
more  technical  than  the  ones  we  have. 


1* 

6. Down 


7. 2 

9. 3. 


12 


4. 


13. 


5. 


14. 

16. 


17. 


19. 

21. 

22 


23. 


24. 


8.  _ 
10. 
11. 

15. 

16. 
18. 
20. 
21. 
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7 inheritance  and  polymorphism 


Better  Living  in 
Objectville 


We  were  underpaid,  ^ 
overworked  coders  'till  we 
tried  the  Polymorphism  Plan.  But 
thanks  to  the  Plan,  our  future  is 
bright.  Yours  can  be  tool 


Plan  your  programs  with  the  future  in  mind.  If  there  were  a way  to  write 

Java  code  such  that  you  could  take  more  vacations,  how  much  would  It  be  worth  to  you?  What 
if  you  could  write  code  that  someone  else  could  extend,  easily?  And  if  you  could  write  code 
that  was  flexible,  for  those  pesky  last-minute  spec  changes,  would  that  be  something  you're 
interested  ln?Then  this  Is  your  lucky  day.  For  just  three  easy  payments  of  60  minutes  time,  you 
can  have  all  this.  When  you  get  on  the  Polymorphism  Plan,  you'll  learn  the  5 steps  to  better  clas< 
design,  the  3 tricks  to  polymorphism,  the  8 ways  to  make  flexible  code,  and  if  you  act  now— a 
bonus  lesson  on  the  4 tips  for  exploiting  inheritance.  Don't  delay, an  offer  this  good  will  give 
you  the  design  freedom  and  programming  flexibility  you  deserve.  It's  quick,  it's  easy,  and  it's 
available  now.  Start  today,  and  well  throw  In  an  extra  level  of  abstraction! 


this  is  a new  chapter  1 Qi 


the  power  of  inheritance 


Chair  Wars  Revisited... 

Remember  way  back  in  chapter  2 , when  Larry  (procedural  guy) 
and  Brad  (00  guy)  were  trying  for  the  Aeron  chmr?  Left  look  at 
a few  pieces  of  that  story  to  review  the  basics  of  inheritance , 

LARRY:  You've  got  duplicated  code!  The  rotate  procedure 
is  in  all  four  Shape  things.  It's  a stupid  design.  You  have  to 
maintain  four  different  rotate  “methods'1.  How  can  that 
ever  be  good? 

BRAD:  Oh,  I guess  you  didn't  see  the  final  design.  Let  me 
show  you  how  OO  inheritance  works,  Larry. 


They're  Shapes,  and  they  all  rotate  and 
playSound.  So  I abstracted  out  the 
common  features  and  put  them  Into  a 
new  class  called  Shape. 


rotateO 

playSound{) 


Vou  can  read  this  as,  “Square  inherits  from  Shape", 
"Circle  Inherits  from  Shape",  and  so  on.  I removed 
rotate()  and  playSound()  from  the  other  shapes,  so  now 
there’s  only  one  copy  to  maintain. 

'iW^hape  class  Is  called  the  superclass  of  the  other  four 
classes.  The  other  four  are  the  subclasses  of  Shape.  The 
subclasses  Inherit  the  methods  of  the  superclass.  In  other 
words,  if  ih&  Shape  class  has  the  functionality,  then  the 
subclasses  automatically  get  that  same  functionality. 


superclass 


rotateO 

pLaySoundO 


subclasses 


Then  I (inked  the  other 
four  shape  classes  to 
the  new  Shape  class. 

In  a relationship  called 
inheritance. 


'Ajnoeba 
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What  about  the  Amoeba  rotated? 


LARRY:  Wasn't  that  the  whole  problem  here  — that  the  amoeba 
had  a completely  different  rotate  and  playSound  procedure? 

How  can  amoeba  do  something  different  if  it  inherits  its 
functionality  from  the  Shape  class? 

BRAD:  That's  the  last  step.  The  Amoeba  class  overrides  the 
methods  of  the  Shape  class.  Then  at  runtime,  the  JVM  knows 
exactly  which  rotate{)  method  to  run  when  someone  tells  the 
Amoeba  to  rotate. 


shape 


O 

( wade  the  Amoeba  class  override  the 
rotate!)  and  playSoundO  methods 
of  the  superclass  Shape.  Overriding 
Just  means  that  a subclass  redefines 
one  of  its  inherited  methods  when 
It  needs  to  change  or  extend  the 
[behavior  of  that  method. 

kv. 

X^'  Overriding  methods 


1* 


How  would  you  represent  a house  cat  and  a tiger,  in  an 
inheritance  structure.  Is  a domestic  cat  a specialized 
version  of  a tiger?  Which  would  be  the  subclass  and 
which  would  be  the  superclass?  Or  are  they  both 
subclasses  to  some  other  class? 

How  would  you  design  an  Inheritance  structure?  What 
methods  would  be  overridden? 

Think  about  It.  Before  you  turn  the  page. 
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Understanding  Inheritance 

When  you  design  with  inheritance,  you  put  common  code  in 
a class  and  then  tell  other  more  specific  classes  that  the 
common  (more  abstract)  class  is  their  superclass.  When  one 
class  inherits  from  another,  the  subclass  inherits  from  the 
superclass* 

In  Java,  we  say  that  the  subclass  extends  the  superclass. 
An  inheritance  relationship  means  that  the  subclass  inherits 
the  members  of  the  superclass.  When  we  say  “members  of 
a class'’  we  mean  the  instance  variables  and  methods. 

For  example,  if  PantherMan  is  a subclass  of  SuperHero,  the 
PantherMan  class  automatically  inherits  the  instance  variables 
and  methods  common  to  all  superheroes  including  suit, 
tights,  spec ialPower,  useSpecialPower  ( ) and 
so  on.  But  the  PantherMan  subclass  can  add  new 
methods  and  instance  variables  of  its  own,  and  it  can 
override  the  methods  it  inherits  from  the  superclass 
SuperHero. 


cuperoiacc 
(more  abstract} 


subclasses 
(more  specif  lei 


SuperHero 

suit 

lights 

special  Power 


useSpedalPowerfl 

putOnSuttQ 


instance  variables 

(state,  attributes) 

methods 

(behavior) 


PantherMan 


useSpeclalPowerQ 

putOnSultQ 


Overriding 

methods 


1 FriedEggMan  doesn't  need  any  behavior  that's  unique, 
so  he  doesn’t  override  any  methods.  The  methods  and 
instance  variables  in  SuperHero  are  sufficient. 
PantherMan,  though,  has  specific  requirements  for  his  suit 
and  special  powers,  so  useSpecialPower  ( ) and 
putOnSuit  ( ) are  both  overridden  in  the  PantherMan 


class. 

Instance  variables  are  not  overridden  because  they 
don’t  need  to  be.  They  don’t  define  any  special  behavior,  so  a 
subclass  can  give  an  inherited  instance  variable  any  value  it 
chooses.  PantherMan  can  set  his  inherited  tights  to 
purple,  while  FriedEggMan  sets  his  to  white. 


inheritance  and  polymorphism 


Ah  Inheritance  example; 

public  class  Doctor  { 

boolean  worksAtfiospital; 

void  treatPatient t)  ( 

//  perform  a checkup 


) 


) 


public  class  FamilyDoctor  extends  Doctor  { 

boolean  makesHouseCalls; 
void  giveAdvice{)  { 

//  give  homespun  advice 

) 


) 


public  class  Surgeon  extends  Doctor { 

void  treatPatient  ()  ( 

ii  perform  surgery 

) 


void  makelncision ()  f 

//  make  incision  (yikes!) 

) 


superclass 


Doctor 


worksAtHospttal 


treatPatient  0 


subclasses 


Overrides  the  Inherited 
treatPatlentO  method 

Adds  one  new  method 


one  instance  variable 
one  method 


Surgeon 

i 

FamilyDoctor 

treatPatient  {) 
makelnclslonO 

makesHouseCalls 

giveAdvIce  0 

Adds  one  new 
instance  variable 

Adds  one  new  method 


-^flrpen  your  pencil 


How  many  instance  variables  does 
Surgeon  have? 

How  many  instance  variables  does 
FamilyDoctor  have? 

How  many  methods  does  Doctor  have? 

How  many  methods  does  Surgeon  have? 

How  many  methods  does  FamilyDoctor 
have? 

Can  a FamilyDoctor  do  treatPatient()? 

Can  a FamilyDoctor  do  makelncislonQ? 
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Let's  design  the  inheritance  tree  for 
an  Animal  simulation  program 

Imagine  you're  asked  to  design  a simulation  program  that 
lets  the  user  throw  a bunch  of  different  animals  into  an 
environment  to  see  what  happens.  We  don’t  have  to  code  the 
thing  now,  we’re  mostly  interested  in  the  design. 

We’ve  been  given  a list  of  some  of  the  animals  that  will  be 
in  the  program,  but  not  all.  We  know  that  each  animal  will 
be  represented  by  an  object,  and  that  the  objects  will  move 
around  in  the  environment,  doing  whatever  it  is  that  each 
particular  type  is  programmed  to  do. 

And  we  want  other  programmers  to  be  able  to  add  new 
kinds  of  animals  to  die  program  at  any  time . 

First  we  have  to  figure  out  the  common,  abstract 
characteristics  that  all  animals  have,  and  build  those 
characteristics  into  a class  that  all  animal  classes  can  extend. 


OLook  for  objects  that  have  common 
attributes  and  behaviors. 


What  do  these  six  types  have  In 
common?  This  helps  you  to  abstract 
out  behaviors,  (step  2) 


How  are  these  types  related?  This 
helps  you  to  define  the  inheritance 
tree  relationships  (step  4-5) 
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Using  inheritance  to  avoid 
duplicating  code  in  subclams 

We  have  five  instance  variables: 

picture  ~ the  fide  name  representing  the  JPEG  of  this  animal 

food  - the  type  of  food  this  animal  eats.  Right  now,  there 
can  be  only  two  values:  meat  or  grass . 

hunger-  an  int  representing  the  hunger  level  of  the  animal. 
It  changes  depending  on  when  (and  how  much)  the 
animal  eats. 

boundaries  - values  representing  the  height  and  width  of 
the  ‘space’  (for  example,  640  x 480)  that  the  animals  will 
roam  around  in. 


0 

Design  a class  that  represents 
the  common  state  and  behavior. 

These  objects  are  all  animals,  so 
we'll  make  a common  superclass 
called  Animal. 

We'll  put  In  methods  and  Instance 
variables  that  all  animals  might 
need. 


location  ~ the  X and  Y coordinates  for  where  the  animal  is 
in  the  space. 

We  have  four  methods: 

makeNoise  ()  - behavior  for  when  the  animal  is  supposed  to 
make  noise. 

eat()  - behavior  for  when  the  animal  encounters  its 
preferred  food  source,  meat  or  grass . 

sleep()  - behavior  for  when  the  animal  is  considered  asleep. 

roam()  - behavior  for  when  the  animal  is  not  eating  or 
sleeping  (probably  just  wandering  around  waiting  to  bump 
into  a food  source  or  a boundary) . 


picture 

food 

hunger 

boundaries 

location 
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Po  all  animals  eat  the  same  way? 

Assume  that  we  all  agree  on  one  thing:  the  instance 
variables  will  work  for  all  Animal  types.  A lion  will 
have  his  own  value  for  picture,  food  (we’re  thinking 
meat),  hunger,  boundaries,  and  location.  A hippo 
will  have  different  values  for  his  instance  variables, 
but  he’ll  still  have  the  same  variables  that  the  other 
Animal  types  have.  Same  with  dog,  tiger,  and  so  on. 

But  what  about  behavior? 


©Decide  if  a subclass 

needs  behaviors  (method 
implementations)  that  are  specific 
to  that  particular  subclass  type. 


Which  methods  should  we  override? 

Does  a lion  make  the  same  noise  as  a dog?  Does 
a cat  eat  like  a hippo?  Maybe  in  ^ourversion,  but 
in  ours,  eating  and  making  noise  are  Animal-type- 
specific.  We  can’t  figure  out  how  to  code  those 
methods  in  such  a way  that  they’d  work  for  any 
animal.  OK,  that’s  not  true.  We  could  write  the 
makeNoiseO  method,  for  example,  so  that  all  it  does 
is  play  a sound  file  defined  in  an  instance  variable 
for  that  type,  but  that’s  not  very  specialized.  Some 
animals  might  make  different  noises 
for  different  situations  (like  one 
for  eating,  and  another  when 
bumping  into  an  enemy,  etc.) 

So  just  as  with  the  Amoeba 
overriding  the  Shape  class  rotate () 
method,  to  get  more  amoeba-specific  (in 
other  words,  unique)  behavior,  we’ll  have 
to  do  the  same  for  our  Animal  subclasses. 


Animal 


picture 

food 

hunger 

boundaries 

location 

makeNoiseO 

eat() 

sleepQ 

roam() 


Looking  at  the  Animal  class, 
we  decide  that  eatO  and 
makeNoiseO  should  be  overridden 
by  the  individual  subclasses. 


In  the  dog 

community,  barking  is  an 
important  part  of  our  cultural 
identity.  We  have  a unique  sound, 
and  we  want  that  diversity  to 
be  recognized  and  respected. 


deW  rb  ( q aru 

^*3  Koise-  f **  1 r 

roiirD  tin  stay 
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Looking  for  more  inheritance 
opportunities 

The  class  hierarchy  is  starting  to  shape  up.  We 
have  each  subclass  override  the  makeNoiseQ  and 
eat()  methods,  so  that  there's  no  mistaking  a Dog 
bark  from  a Cat  meow  (quite  insulting  to  both 
parties).  And  a Hippo  won’t  eat  like  a Lion. 

But  perhaps  there’s  more  we  can  do.  We  have  to 
look  at  the  subclasses  of  Animal,  and  see  if  two 
or  more  can  be  grouped  together  in  some  way, 
and  given  code  that’s  common  to  only  that  new 
group.  Wolf  and  Dog  have  similarities.  So  do 
Lion,  Tiger,  and  Cat. 


O 

Look  for  more  opportunities  to  use 
abstraction,  by  finding  two  or  more 
subclasses  that  might  need  common 
behavior. 

We  look  at  our  classes  and  see 
that  Wolf  and  bog  might  have  some 
behavior  in  common,  and  the  same  goes 
for  Lion,  Tiger,  and  Cat. 


^ \Lv 


Animal 

picture 

food 

hunger 

boundaries 

location 


makeNoiseQ 

eatQ 

sleep() 

roam() 


\\ 

WoK 

Cat 

makeNoiseO 

eat() 

makeNoiseO 

eat<) 

“Wj 
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Which  method  i$  called? 


The  Wolf  class  has  four  methods.  One 
inherited  from  Animal,  one  inherited  from 
Canine  (which  is  actually  an  overridden 
version  of  a method  in  class  Animal) , and 
two  overridden  in  the  Wolf  class.  When 
you  create  a Wolf  object  and  assign  it  to 
a variable,  you  can  use  the  dot  operator 
on  that  reference  variable  to  invoke  all 
four  methods.  But  which  version  of  those 
methods  gets  called? 


make  a new  Woi-f  object 

calls  tkc  version  in 


Wolf  w = new  Wolf(); 
w .makeNoise  () ; 


calls  the  version  m Canine  w * roam  ( ) ; 


Calls  tke  version  in  Wol£ 


w.eatO  ; 


calls  the  version  in  Animal  w . sleep  ( ) ; 


When  you  call  a method  on  an  object 
reference,  you're  calling  the  most  specific 
version  of  the  method  for  that  object  type. 

In  other  words,  the  lowest  one  wins l 

"Lowest0  meaning  lowest  on  the 
inheritance  tree.  Canine  is  lower  than 
Animal,  and  Wolf  is  lower  than  Canine, 
so  invoking  a method  on  a reference 
to  a Wolf  object  means  the  JVM  starts 
looking  first  in  the  Wolf  class.  If  the  JVM 
doesn't  find  a version  of  the  method  in 
the  Wolf  class,  it  starts  walking  back  up 
the  inheritance  hierarchy  until  it  finds  a 
match. 


z 

Canine  | 
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^signing  an  Inheritance  Tree 


Class 

Superclasses 

Subclasses 

Clothing 

— 

Boxers,  Shin 

Boxers 

Clothing 

Shirt 

Clothing 

Inheritance  Table 


superclass 
(wore  abstract) 


Clothing 


subclasses 
(more  specific) 


pencil 


Class 

Superclasses 

Subclasses 

Musician 

Rock  Star 

Fan 

Bass  Player 

Concert  Pianist 

Hint:  not  everything  can  be  connected  to  something  else. 
Hint : you're  allowed  to  add  to  or  change  the  classes  listed. 


Inheritance  Claes  Diagram 


Draw  an  inheritance  diagram  here. 


DuSiB^uesdcms 


You  iaid  that  the  JVM  starts 
walking  up  the  Inheritance  tree, 
starting  at  the  class  type  you  Invoked 
the  method  on  (like  the  Wolf  example 
on  the  previous  page).  But  what 
happens  If  the  JVM  doesn't  ever  find 
a match? 


A-  Good  question!  But  you  don't 
have  to  worry  about  that. The  compiler 
guarantees  that  a particular  method 
fs  callable  for  a specific  reference  type, 
but  It  doesn't  say  (or  care)  from  which 
class  that  method  actually  comes  from 
at  runtime. With  the  Wolf  example,  the 
compiler  checks  for  a sleepO  method, 
but  doesn't  care  that  sleepO  Is  actually 
defined  In  (and  Inherited  from)  class 
Animal.  Remember  that  If  a class 
Inherits  a method,  It  has  the  method. 


Where  the  inherited  method  Is  defined 
(In  other  words,  In  which  superclass 
It  Is  defined)  makes  no  difference  to 
the  compiler.  But  at  runtlme,the  JVM 
will  always  pick  the  right  one.  And 
the  right  one  means,  the  most  specific 
version  for  that  particular  object. 
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Using  l$~A  and  HAS-A 


Remember  that  when  one  class 
inherits  from  another*  we  say  that  the 
subclass  extends  the  superclass.  When 
you  want  to  know  if  one  thing  should 
extend  another,  apply  the  ISA  test. 

Triangle  ISA  Shape,  yeah,  that  works. 

Cat  ISA  Feline,  that  works  too. 

Surgeon  ISA  Doctor,  still  good. 

Tub  extends  Bathroom,  sounds 
reasonable. 

Until  you  apply  the  IS-A  test. 

To  know  if  you’ve  designed  your  types 
correctly,  ask,  “Does  it  make  sense  to 
say  type  X ISA  type  Y?”  If  it  doesn't, 
you  know  there’s  something  wrong 
with  the  design,  so  if  we  apply  the  ISA 
test,  Tlib  ISA  Bathroom  is  definitely 
false. 

What  if  we  reverse  it  to  Bathroom 
extends  Tub?  That  still  doesn’t  work, 
Bathroom  ISA  Tlib  doesn’t  work. 

Tlib  and  Bathroom  are  related,  but 
not  through  inheritance.  Tub  and 
Bathroom  are  joined  by  a HASA 
relationship.  Does  it  make  sense  to 
say  “Bathroom  HASA  Tbbn?  If  yes, 
then  it  means  that  Bathroom  has  a 
Tub  instance  variable.  In  other  words, 
Bathroom  has  a reference  to  a Tub,  but 
Bathroom  does  not  extend  T\ib  and 
vice-versa. 


boes  it  make  sense  to 
say  a Tub  I5-A  Bathroom?  Or  a 
Bathroom  IS-A  Tub?  Well  it  doesn't  to 
me.  The  relationship  between  my  Tub 
and  my  Bathroom  is  HAS-A.  Bathroom 
HA5-A  Tub.  That  means  Bathroom 
has  a Tub  instance  variable. 


Bathroom 


Tub  bathtub; 
SrnktheSink; 


Bubble 

tot radius; 

H colorAmt; 


Tub 

Intsize; 
Bubbles  b; 


Bathroom  HASA  Tub  and  Tub  HASA  Bubbles. 
But  nobody  Inherits  from  (extends)  anybody  else. 
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But  wait!  There's  more! 

The  IS-A  test  works  anywhere  in  the  inheritance  tree.  If  your 
inheritance  tree  is  well-designed!  the  ISA  test  should  make 
sense  when  you  ask  any  subclass  if  it  IS*A  any  of  its  supertypes. 


If  class  B extends  class  A,  class  B IS -A  class  A. 

This  Is  true  anywhere  in  the  inheritance  tree.  If 
class  C extends  class  B,  class  C passes  the  IS-A 
test  for  both  B and  A. 


Canine  extends  Animal 
Wolf  extends  Canine 
Woif  extends  Animal 

Canine  IS-A  Animal 
Wolf  IS-A  Canine 
Wolf  IS-A  Animal 


Animal 


makeNolse() 

eat() 

sleep{) 

roam() 


Canine 


roam() 


Wolf 


ma  ke  Noise  () 
eat() 


w 


With  an  inheritance  tree  like  the 
one  shown  here,  you're  always 
allowed  to  say  “Wolf  extends 
Animal”  or  “Wolf  IS-A  Animal”. 

It  makes  no  difference  if  Animal 
is  the  superclass  of  the  superclass 
of  Wolf.  In  fact,  as  long  as  Animal 
is  somewhere  in  the  inheritance 
hierarchy  above  Wolf,  Wolf  IS-A 
Animal  will  always  be  true. 

The  structure  of  the  Animal 
inheritance  tree  says  to  the  world: 

"Wolf  IS-A  Canine,  so  Wolf  can  do 
anything  a Canine  can  do.  And 
Wolf  IS-A  Animal,  so  Wolf  can  do 
anything  an  Animal  can  do.” 

It  makes  no  difference  if  Wolf 
overrides  some  of  the  methods 
in  Animal  or  Canine.  As  far  as 
the  world  (of  other  code)  is 
concerned,  a Wolf  can  do  those 
four  methods.  Maw  he  does  them, 
or  in  which  class  they're  overridden 
makes  no  difference.  A Wolf  can 
makeNoiseO,  eat()>  sleep (),  and 
roam()  because  a Wolf  extends 
from  class  Animal. 
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How  do  you  know  if  you've  got 
your  inheritance  right? 

There's  obviously  more  to  it  than  what  we've 
covered  so  far,  but  we'll  look  at  a lot  more  OO 
issues  in  the  next  chapter  (where  we  eventually 
refine  and  improve  on  some  of  the  design  work 
we  did  in  this  chapter). 

For  now,  though,  a good  guideline  is  to  use  the 
IS-A  test  If  “X  IS-A  Y”  makes  sense,  both  classes 
(X  and  Y)  should  probably  live  in  the  same 
inheritance  hierarchy.  Chances  are,  they  have 
the  same  or  overlapping  behaviors. 

Keep  in  mind  that  the 
inheritance  IS-A  relationship 
works  in  only  one  direction! 

Triangle  IS-A  Shape  makes  sense,  so  you  can 
have  Triangle  extend  Shape. 

But  the  reverse — Shape  IS-A  Triangle — does 
not  make  sense,  so  Shape  should  not  extend 
Triangle,  Remember  that  the  IS-A  relationship 
implies  that  if  X IS-A  Y,  then  X can  do  anything 
a Y can  do  (and  possibly  more) , 


EKW***' 

S3.V.X* 


Put  a check  next  to  the  relationships  that 
make  sense. 

G Oven  extends  Kitchen 
D Guitar  extends  Instrument 
G Person  extends  Employee 
G Ferrari  extends  Engine 
G FriedEgg  extends  Food 
G Beagle  extends  Pet 
G Container  extends  Jar 
G Metal  extends  Titanium 
G Grateful  Dead  extends  Band 
G Blonde  extends  Smart 
G Beverage  extends  Martini 


Sharpen  your  pencil 


Hint  apply  the  IS-A  tost 
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DuSl?tJuest!pns 

So  we  see  how  a subclass  gets 
to  Inherit  a superclass  method,  but 
what  If  the  superclass  wants  to  use 
the  subclass  version  of  the  method? 

A superclass  won't  necessarily 
know  about  any  of  its  subclasses. 

You  might  write  a class  and  much 
later  someone  else  comes  along  and 
extends  it.  But  even  If  the  superclass 
creator  does  know  about  (and  wants 
to  use)  a subclass  version  of  a method, 
there's  no  sort  of  reverse  or  backwards 
inheritance.  Think  about  it, children 
Inherit  from  parents,  not  the  other  way 
around. 


Q/  In  a subdasj,what  if  I want  to 
use  BOTH  the  superclass  version  and 
my  overriding  subclass  version  of  a 
method?  In  other  words,  I don't  want 
to  completely  replace  the  superclass 
version,  I just  want  to  add  more  stuff 
to  It. 


You  can  do  this!  And  It's  an 
important  design  feature. Thinkof  the 
word  "extends"  as  meaning, "I  want 
to  extend  the  functionality  of  the 
superclass" 

public  void  roam()  { 
super . roam () ; 

//  my  own  roam  stuff 


You  can  design  your  superclass 
methods  in  such  a way  that  they 
contain  method  implementations 
that  will  work  for  any  subclass,  even 
though  the  subclasses  may  still  need 
to  'append'  more  code.  In  your  subclass 
overriding  method,  you  can  call  the 
superclass  version  using  the  keyword 
super.  It's  like  saying, "first  go  run  the 
superclass  version,  then  come  back  and 
finish  with  my  own  code..." 

tails  inWi-ted  vPrsia*  of 

roa*A  k6k  ^ do 

yoMr  own  suk*lass-s?ctif'fc  todt 


1 


Who  gets  the  Porsche,  who  gets  the  porcelain? 
(how  to  know  what  a subclass  can 
Inherit  from  Its  superclass) 


A subclass  inherits  members  of  the 
superclass.  Members  include  instance 
variables  and  methods,  although  later  in 
tins  book  we’ll  look  at  other  inherited  members.  A 
superclass  can  choose  whether  or  not  it  wants  a 
subclass  to  inherit  a particular  member  by  the  level  of 
access  the  particular  member  is  given. 


There  are  four  access  levels  that  we’ll  cover  in  this  book. 
Moving  from  most  restrictive  to  least,  the  four  access 
levels  are: 


private  default  protected  public 


Access  levels  control  who  sees  what , and  are  crucial 
to  having  we  11 -designed,  robust  Java  code.  For  now  we’ll 
focus  just  on  public  and  private.  The  rules  are  simple  for 
those  two: 

public  members  are  Inherited 
private  members  are  not  Inherited 


When  a subclass  inherits  a member,  it  is  as  if  the 
subclass  defined  the  member  itself.  In  the  Shape 
example,  Square  inherited  the  rotate  ( ) and 
playSoundO  methods  and  to  the  outside  world  (other 
code)  the  Square  class  simply  has  a rotate  ( ) and 
playSoundO  method. 

The  members  of  a class  include  the  variables  and 
methods  defined  in  the  class  plus  anything  inherited 
from  a superclass. 
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When  designing  with  inheritance, 
are  you  using  or  abusing? 

Although  some  of  the  reasons  behind  these  rules  won't  be 
revealed  until  later  in  this  book,  for  now,  simply  kmnmngz 
few  rules  will  help  you  build  a better  inheritance  design. 


DO  use  inheritance  when  one  class  is  a more  specific  type 
of  a superclass.  Example:  Willow  u a more  specific  type  of 
Tree,  so  Willow  extends  Jrtt  makes  sense. 


DO  consider  inheritance  when  you  have  behavior 
(implemented  code)  that  should  be  shared  among 
multiple  classes  of  the  same  general  type.  Example: 
Square,  Circle,  and  Triangle  all  need  to  rotate  and  play 
sound,  so  putting  that  functionality  in  a superclass  Shape 
might  make  sense,  and  makes  for  easier  maintenance  and 
extensibility.  Be  aware,  however,  that  while  inheritance  is 
one  of  the  key  features  of  object-oriented  programming, 
it's  not  necessarily  the  best  way  to  achieve  behavior  reuse. 
It'll  get  you  started,  and  often  it's  the  right  design  choice, 
but  design  patterns  will  help  you  see  other  more  subtle 
and  flexible  options.  If  you  don't  know  about  design 
patterns,  a good  follow-on  to  this  book  would  be  Head  First 
Design  Patterns. 


DO  NOT  use  inheritance  just  so  that  you  can  reuse 
code  from  another  class,  if  the  relationship  between  the 
superclass  and  subclass  violate  either  of  the  above  two 
rules.  For  example,  imagine  you  wrote  special  printing 
code  in  the  Alarm  class  and  now  you  need  printing  code 
in  the  Piano  class,  so  you  have  Piano  extend  Alarm  so  that 
Piano  inherits  the  printing  code.  That  makes  no  sensei  A 
Piano  is  not  a more  specific  type  of  Alarm.  (So  the  printing 
code  should  be  in  a Printer  class,  that  all  printable  objects 
can  take  advantage  of  via  a HAS-A  relationship.) 


DO  NOT  use  inheritance  if  the  subclass  and  superclass 
do  not  pass  the  IS-A  test.  Always  ask  yourself  if  the  subclass 
IS-A  more  specific  type  of  the  superclass.  Example:  Tea  IS- 
A Beverage  makes  sense.  Beverage  IS-A  Tea  does  not. 


— BULLET  POINTS  

■ A subclass  extends  a superclass. 

■ A subclass  Inherits  all  public  Instance 
variables  and  methods  of  the  superclass,  but 
does  not  Inherit  the  private  Instance  variables 
and  methods  of  the  superclass. 

■ Inherited  methods  can  be  ovem'dden;  instance 
variables  cannot  be  overridden  (although  they 
can  be  redefined  in  the  subclass,  but  that's 
not  the  same  thing,  and  there's  almost  never  a 
need  to  do  it) 

■ Use  the  IS-A  test  to  verify  that  your 
inheritance  hierarchy  is  valid.  If  X extends  Y, 
then  X IS-A  V must  make  sense. 

■ The  IS-A  relationship  works  In  only  one 
direction.  A Hippo  Is  an  Animal,  but  not  all 
Animals  are  Hippos. 

■ When  a method  is  overridden  in  a subclass, 
and  that  method  is  Invoked  on  an  instance  of 
the  subclass,  the  overridden  version  of  the 
method  is  called.  (The  lowest  one  wins.) 

■ If  class  B extends  A,  and  C extends  8,  class 
B IS-A  class  A,  and  class  C IS-A  class  8,  and 
class  C also  IS-A  class  A. 
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So  what  does  all  this 
inheritance  really  buy  you? 


You  get  a lot  of  OO  mileage  by  designing 
with  inheritance.  You  can  get  rid  of  duplicate 
code  by  abstracting  out  the  behavior  common 
to  a group  of  classes,  and  sticking  that  code 
in  a superclass.  That  way,  when  you  need  to 
modify  it,  you  have  only  one  place  to  update, 
and  the  change  is  magically  reflected  in  all  the 
classes  that  inherit  that  behavior.  Well,  there's 
no  magic  involved,  but  it  is  pretty  simple: 
make  the  change  and  compile  the  class 
again.  That's  it.  You  don’t  have  to  touch  the 
subclasses! 

Just  deliver  the  newly-changed  superclass,  and 
all  classes  that  extend  it  will  automatically  use 
the  new  version, 

AJava  program  is  nothing  but  a pile  of  classes, 
so  the  subclasses  don’t  have  to  be  recompiled 
in  order  to  use  the  new  version  of  the 
superclass.  As  long  as  the  superclass  doesn't 
break  anything  for  the  subclass,  everything’s 
fine.  (We’U  discuss  what  the  word  'break* 
means  in  this  context,  later  in  the  book.  For 
now,  think  of  it  as  modifying  something  in 
the  superclass  that  the  subclass  is  depending 
on,  like  a particular  method’s  arguments  or 
return  type,  or  method  name,  etc.) 


^ You  avoid  duplicate 
code. 

Put  common  code  in  one  place,  and  let 
the  subclasses  inherit  that  code  from  a 
superclass.  When  you  want  to  change  that 
behavior,  you  have  to  modify  it  in  only 
one  place,  and  everybody  else  (i.e.  all  the 
subclasses)  see  the  change. 


® You  define  a common 


protocol  for  a group  of 

classes-  — 


Um,  what 
the  heck  does 
THAT  mean? 
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Inheritance  lets  you  guarantee  that 
all  classes  grouped  under  a certain 
supertype  have  all  the  methods  that 
the  supertype  has* 

In  other  words,  you  define  a common  protocol  for  a 
set  of  classes  related  through  Inheritance. 

When  you  define  methods  in  a superclass,  that  can  be 
inherited  by  subclasses,  you're  announcing  a kind  of 
protocol  to  other  code  that  says,  “All  ray  subtypes  <Le. 
subclasses)  can  do  these  things,  with  these  methods 
that  look  like  this...* 

In  other  words,  you  establish  a contract 

Class  Animal  establishes  a common  protocol  for  all 
Animal  subtypes: 


And  I care  because... 

Because  you  get  to  take  advantage  of 
polymorphism. 


Which  matters  to  me 
because... 

Because  you  get  to  refer  to  a subclass 
object  using  a reference  declared  as  the 
supertype. 


Animal 


makeNolse() 

eat() 

sleep() 

roamQ 


to*  ^ 

Ml  a* 

, rut 

toff**- 


And  remember,  when  we  say  any  Animat,  we  mean 
Animal  and  any  class  that  extends  from  Animal  Which 
again  means,  any  class  that  has  Animal  somewhere  above  it 
in  the  inheritance  hierarchy . 

But  we're  not  even  at  the  really  cool  part  yet,  because 
we  saved  the  best — polymorphism — for  last 

When  you  define  a supertype  for  a group  of  classes, 
any  subclass  of  that  supertype  can  be  substituted  where  the 
supertype  is  expected . 

Say,  what? 

Don’t  worry,  we’re  nowhere  near  done  explaining  it 
Two  pages  from  now,  you'll  be  an  expert. 


And  that  means  to  me... 


You  get  to  write  really  flexible  code. 
Code  that's  cleaner  (more  efficient, 
simpler).  Code  that's  not  just  easier  to 
develop,  but  also  much,  much  easier  to 
extend,  in  ways  you  never  imagined  at 
the  time  you  originally  wrote  your  code. 

That  means  you  can  take  that  tropical 
vacation  while  your  co-workers  update 
the  program,  and  your  co-workers  might 
not  even  need  your  source  code. 


You'll  see  how  it  works  on  the  next  page. 

We  don't  know  about  you,  but 
personally,  we  find  the  whole 
tropical  vacation  thing  t 
particularly  motivating. 

■&J 


"When  we  say  “all  the  methods"  we  mean  “all  the  Inheritable  methods",  which 
for  now  actually  means,  “all  the  public  methods",  although  later  we’tl  refine  that 
definition  a bit  more. 


you  are  here  ► 183 


the  way  polymorphism  works 


The  3 steps  of  object 
declaration  and  assignment 


To  see  how  polymorphism 
works,  we  have  to  step  back 
and  look  at  the  way  we 
normally  declare  a reference 
and  create  an  object... 


Dog  myDog  = new  Dog()  ; 


O Declare  a reference 
variable 


Dog  myDog  » new  Dog()  ; 

Tells  the  JVM  to  allocate  space  for  a 
reference  varlable.The  reference  variable 
is,  forever,  of  type  Dog,  In  other  words, 
a remote  control  that  has  buttons  to 
control  a Dog,  but  not  a Cat  or  a Button 
or  a Socket. 


Create  an  object 

Dog  myDog  = new  Dog  ( ) ; 

Tells  the  JVM  to  allocate  space  for 
a new  Dog  object  on  the  garbage 
collectible  heap. 


Dog  object 


Link  the  object 
and  the  reference 


Dog  myDog  = new  Dog()  ; 

Assigns  the  new  Dog  to  the  refer- 
ence variable  myDog.  In  other  words, 

program  the  remote  control . 


Dog  object 
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The  important  point  is  that  the 
reference  type  AND  the  object 
type  are  the  same. 


In  this  example,  both  are  Dog. 


These  two  are  the  same  type-  The  re-ferente 
variable  type  is  declared  as  Do^,  and  the  object 
is  treated  as  new  P05O. 


But  with  polymorphism,  the 
reference  and  the  object  can 
be  different. 


Animal  myDog 


Animal 


= new  Dog  ()  ; 


These  two  are  HOT  the  same  type-  The 
re-ferente  variable  type  is  declared  as  Animal, 
but  the  object  is  treated  as  new  Pod/)- 
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polymorphism  In  action 


With  polymorphism,  the  reference 
type  can  be  a superclass  of  the 
actual  object  type. 

When  you  declare  a reference  variable, 
any  object  that  passes  the  ISA  test  for  the 
declared  type  of  the  reference  variable 
can  be  assigned  to  that  reference.  In 
other  words,  anything  that  extends  the 
declared  reference  variable  type  can 
be  assigned  to  the  reference 
variable.  This  lets  you  do 
things  like  make  polymorphic 
arrays . 


OK,  OK  maybe  an  example  will  help. 

Animal  []  animals  = new  Animal  [5]  ; 
animals  [0]  = new  Dog(); 

animals  [1]  = new  Cat()  ; 

animals  [2]  = new  Wolf  ()  ; 

animals  13]  = new  Hippo  () 

animals  [4]  = new  Lion(); 


Bu-fc  look  wkat  you  Jft  ho  do...  you  tan  put  m 
subdlais  of  /t»>i»wal  in  £kt  A1*1 arvayf 


s 


het-c'%  ii,  L i 


- V0°Je  It),  y 

for  (int  i = 0;  i < animals . length;  i++)  { ">*  1 ind  &j/l 


rou 

o*c 


) 


animals [i] .eat  () 


animals  [i]  . roam()  ; 


When  V IS  0,  a Do$  is  at.  mde*  0 i*  the^  array*  SO 
you  get  the  Dog's  catO  method-  When  p is  I,  you 

grt  the  Cat/s  ea-M)  method 
Sa^e  wth  >roa»0. 
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But  wait!  There’s  more! 


You  can  have  polymorphic 
arguments  and  return  types. 

If  you  can  declare  a reference  variable 
of  a supertype,  say,  Animal,  and  assign  a 
subclass  object  to  it,  say,  Dog,  think  of  how 
that  might  work  when  the  reference  is  an 
argument  to  a method... 


class  Vet  { 

public  void  giveShot (Animal  a)  { 

//do  horrible  things  to  the  Animal  at 
//  the  other  end  of  the  'a7  parameter 
a.makeNoise()  ; 

> 


“ 'Wily  oui  tier,  d.  Aiinal 


class  PetOwner  ( 

public  void  start ()  { 

Vet  v = new  Vet()  ; 

Dog  d = new  Dog()  ; 
Hippo  h = new  Hippo  ()  ; 

v.giveShot (d)  ; 

v . giveShot (h) ; ^ 


TW  Vrfi  aiveSViot^  toy 

uou  ?a«  -It*  a*  a a *«*>- 

ft*i»ral>  i-t  will  work- 


Do$  s makcKoiieO  ruhS 
%o's  ^keWweO  ruw 


} 


} 
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exploiting  the  power  of  polymorphism 


With  polymorphism,  you  can  write  code  that  doesn't 
have  to  change  when  you  Introduce  new  cubelas* 
types  Into  the  program. 


NOW  X get  itl  If  I write 
my  code  using  polymorphic  arguments, 
where  I declare  the  method  parameter  as  a 
superclass  type,  I can  pass  in  any  subclass  object  at 
runtime.  Cool.  Because  that  also  means  I can  write  my 
code,  go  on  vacation,  and  someone  else  can  add  new 
subclass  types  to  the  program  and  my  methods  wifi 
still  work.,,  (the  only  downside  is  T m just  making  life 
easier  for  that  idiot  Jim). 


Remember  that  Vet  class?  If  you  write  that  Vet  class  using 
arguments  declared  as  type  Animal  your  code  can  handle  any 
Animal  subclass.  That  means  if  others  want  to  take  advantage  of 
your  Vet  class,  all  they  have  to  do  is  make  sure  their  new  Animal 
types  extend  class  Animal.  The  Vet  methods  will  still  work,  even 
though  the  Vet  class  was  written  without  any  knowledge  of  the 
new  Animal  subtypes  the  Vet  will  be  working  on. 


Why  is  polymorphism  guaranteed  to  work  this  way?  Why  is 
it  always  safe  to  assume  that  any  subclass  type  will  have  the 
methods  you  think  you're  calling  on  the  superclass  type  (the 
superclass  reference  type  you're  using  the  dot  operator  on)? 
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C^rail^t^uestiPns 


Are  there  any  practical  limits 
on  the  levels  of  subclassing?  How 
deep  can  you  go? 

If  you  look  in  the  Java  API, 
you'll  see  that  most  inheritance 
hierarchies  are  wide  but  not  deep. 
Most  are  no  more  than  one  or  two 
levels  deep,  although  there  are 
exceptions  (especially  in  the  GUI 
classes). You'll  come  to  realize  that 
it  usually  makes  more  sense  to  keep 
your  inheritance  trees  shallow,  but 
there  isn't  a hard  limit  (well,  not  one 
that  you'd  ever  run  into). 

Hey,  I just  thought  of 
something...  if  you  don't  have 
access  to  the  source  code  for  a class, 
but  you  want  to  change  the  way  a 
method  of  that  class  works,  could 
you  use  subclassing  to  do  that?  To 
extend  the  “bad"  class  and  override 
the  method  with  your  own  better 
code? 

Yep. That's  one  cool  feature 
of  00,  and  sometimes  it  saves  you 
from  having  to  rewrite  the  class 
from  scratch,  or  track  down  the 
programmer  who  hid  the  source  code. 


VJ/  Can  you  extend  any  class?  Or 
is  it  like  class  members  where  if  the 
class  is  private  you  can't  inherit  it... 

There's  no  such  thing  as  a 
private  class,  except  in  a very  special 
case  called  an  inner  class,  that  we 
haven't  looked  at  yet.  But  there  are 
three  things  that  can  prevent  a class 
from  being  subclassed. 

The  first  is  access  control.  Even  though 
a class  can't  be  marked  private,  a 
class  can  be  non-public  (what  you 
get  if  you  don't  declare  the  class  as 
public).  A non-public  class  can  be 
subclassed  only  by  classes  in  the 
same  package  as  the  class.  Classes  in 
a different  package  won't  be  able  to 
subclass  (or  even  use,  for  that  matter) 
the  non-public  class. 

The  second  thing  that  stops  a class 
from  being  subclassed  is  the  keyword 
modifier  final.  A final  class  means 
that  it's  the  end  of  the  inheritance 
line.  Nobody,  ever,  can  extend  a final 
class. 

The  third  issue  is  that  if  a class  has 
only  private  constructors  (we'll 
look  at  constructors  in  chapter  9),  it 
can't  be  subclassed. 


Why  would  you  ever  want  to 
make  a final  class?  What  advantage 
would  there  be  In  preventing  a class 
from  being  subclassed? 

Typically,  you  won't  make  your 
classes  final.  But  if  you  need  security 
— the  security  of  knowing  that  the 
methods  will  always  work  the  way 
that  you  wrote  them  (because  they 
can't  be  overridden),  a final  class 
will  give  you  that.  A lot  of  classes  in 
the  Java  API  are  final  for  that  reason. 
The  String  class, for  example,  is  final 
because,  well,  imagine  the  havoc  if 
somebody  came  along  and  changed 
the  way  Strings  behave! 


Q;  Can  you  make  a method  final, 
without  making  the  whole  class 
final? 


If  you  want  to  protect  a specific 
method  from  being  overridden,  mark 
the  method  with  the  finalmodifier. 
Mark  the  whole  class  as  final  if  you 
want  to  guarantee  that  none  of  the 
methods  in  that  class  will  ever  be 
overridden. 
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Keeping  the  contract:  rules  for  overriding 


When  you  override  a method  from  a superclass,  you’re  agreeing  to 
fulfill  the  contract  The  contract  that  says,  for  example,  T take  no 
arguments  and  I return  a boolean.”  In  other  words,  the  arguments 
and  return  types  of  your  overriding  method  must  look  to  the  outside 
world  exactly  like  the  overridden  method  in  the  superclass. 

The  methods  are  the  contract 

If  polymorphism  is  going  to  work,  the  Toaster’s  version  of  the 
overridden  method  from  Appliance  has  to  work  at  runtime. 
Remember,  the  compiler  looks  at  the  reference  type  to  decide 
whether  you  can  call  a particular  method  on  that  reference.  With 
an  Appliance  reference  to  a Toaster,  the  compiler  cares  only  if  class 
Appliance  has  the  method  you’re  invoking  on  an  Appliance  reference. 
But  at  runtime,  the  JVM  looks  not  at  the  reference  type  (Appliance)  but 
at  the  actual  Toaster  object  on  the  heap.  So  if  the  compiler  has  already 
approved  the  method  call,  the  only  way  it  can  work  is  if  the  overriding 
method  has  the  same  arguments  and  return  types.  Otherwise, 
someone  with  an  Appliance  reference  will  call  turn  On  ()  as  a no- 
arg  method,  even  though  there’s  a version  in  Toaster  that  takes  an 
int  Which  one  is  called  at  runtime?  The  one  in  Appliance.  In  other 
words,  the  tumOn(int  level)  method  in  T hosier  is  not  an  override ! 

& Arguments  must  be  the  same,  and  return 
types  must  be  compatible. 

The  contract  of  superclass  defines  how  other  code  can  use  a method. 
Whatever  the  superclass  takes  as  an  argument,  the  subclass  over- 
riding the  method  must  use  that  same  argument.  And  whatever  the 
superclass  declares  as  a return  type,  the  overriding  method  must  de- 
clare either  the  same  type,  or  a subclass  type.  Remember,  a subclass 
object  is  guaranteed  to  be  able  to  do  anything  its  superclass  declares, 
so  it's  safe  to  return  a subclass  where  the  superclass  Is  expected. 

$ The  method  can’t  be  less  accessible. 

That  means  the  access  level  must  be  the  same,  or  friendlier.  That 
means  you  can’t,  for  example,  override  a public  method  and  make 
It  private.  What  a shock  that  would  be  to  the  code  invoking  what  It 
to/nks  (at  compile  time)  is  a public  method,  if  suddenly  at  mntime 
the  JVM  slammed  the  door  shut  because  the  overriding  version  Is*® 
called  at  runtime  Is  private!  \u 


Appliance 

boolean  tumOnQ 
boolean  tumOffO 


boolean  tumOn(int  level) 


This  is  finally  j Je„l 


Appliance 

public  boolean  tumOnQ 
public  boolean  tumOnQ 


So  far  weVe  learned  about  two  access  levels:  private  and  public. 
The  other  two  are  In  the  deployment  chapter  (Release  your  Code) 
and  appendix  B.  There’s  also  another  rule  about  overriding  related 
to  exception  handling,  but  we’ll  wait  until  the  chapter  on  exceptions 
(Risky  Behavior)  to  cover  that. 


HOT  -"V 


™ * 

Toaster 

private  boolean  tumOnQ 
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Overloading  a method 

Method  overloading  is  nothing  more  than  having 
two  methods  with  the  same  name  but  different 
argument  lists.  Period.  There’s  no  polymorphism 
involved  with  overloaded  methods! 

Overloading  lets  you  make  multiple  versions 
of  a method,  with  different  argument  lists,  for 
convenience  to  the  callers.  For  example,  if  you 
have  a method  that  takes  only  an  int,  the  calling 
code  has  to  convert,  say,  a double  into  an  int 
before  calling  your  method.  But  if  you  overloaded 
the  method  with  another  version  that  takes  a 
double,  then  you’ve  made  things  easier  for  the 
caller.  You’ll  see  more  of  this  when  we  look  into 
constructors  in  the  object  lifecycle  chapter. 

Since  an  overloading  method  isn’t  trying  to 
fulfill  the  polymorphism  contract  defined  by  its 
superclass,  overloaded  methods  have  much  more 
flexibility. 

0 The  return  types  can  be 
different. 

You’re  free  to  change  the  return  types  in 
overloaded  methods,  as  long  as  the  argument  lists 
are  different. 

6 You  can’t  change  ONLY  the 
return  type. 

If  only  the  return  type  is  different,  it’s  not  a 
valid  overload— the  compiler  will  assume 
you’re  trying  to  override  the  method.  And  even 
that  won’t  be  legal  unless  the  return  type  is 
a subtype  of  the  return  type  declared  in  the 
superclass.  To  overload  a method,  you  MUST 
change  the  argument  list,  although  you  can 
change  the  return  type  to  anything. 

£ You  can  vary  the  access 
levels  in  any  direction. 

You’re  free  to  overload  a method  with  a method 
that’s  more  restrictive.  It  doesn’t  matter,  since  the 
new  method  isn’t  obligated  to  fulfill  the  contract  of 
the  overloaded  method. 


An  overloaded  method  3s 
just  a different  method  that 
happens  to  have  the  same 
method  name.  It  has  nothing 
to  do  with  inheritance  and 
polymorphism.  An  overloaded 
method  is  NOT  the  same  as 
an  overridden  method. 


Legal  examples  of  method 
overloading: 

public  class  Overloads  { 

String  uniquelD; 

public  int  addNums (int  a,  int  b)  { 
return  a + b; 

} 

public  double  addNums (double  a,  double  b)  { 

return  a + b; 

} 

public  void  setUniquelD (String  the ID)  { 

//  lots  of  validation  code,  and  then: 
uniquelD  = thelD; 

} 

public  void  setUniquelD (int  ssNumber)  { 
String  numString  = ""  + ssNumber; 
setUniquelD (numString) ; 
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exercise:  Mixed  Messages 


the  program: 


Mixed 

Messages 

a = 6;_.  56 

b - 5;  >5^  XI 
a - 5;  65 


A short  Java  program  is  listed  below.  One  block  of 
the  program  is  missing!  Your  challenge  Is  to  match 
the  candidate  block  of  code  (on  the  left),  with  the 
output  that  you'd  see  if  the  block  were  Inserted. 

Not  all  the  lines  of  output  will  be  used,  and  some  of 
the  lines  of  output  might  be  used  more  than  once. 
Draw  lines  connecting  the  candidate  blocks  of 
code  with  their  matching  command-line  output. 


class  A { 

class  C extends  B { 

int  ivar  = 7; 

void  m3  ( ) { 

void  ml ( ) { 

System. out - print ( "C 

's  m3,  "+(ivar  + 6)); 

System. out. print ( "A' s ml,  "); 

> 

> 

> 

void  m2 ( ) { 

System. out. print ( "A' s m2, 

public  class  Mixed2  { 

> 

public  static  void  main(String  []  args)  { 

void  m3 ()  { 

A a « new  A ( ) ; 

System. out -print ( "A' s m3, 

B b « new  B ( ) ; 

> 

C c = new  C ( ) ; 

> 

A a2  = new  C( ) ; 

candidate  code 

claaa  B extends  A { 

^ goes  here 
(three  llhes) 

void  ml  ()  { 

System. out. print ( "S' a ml,  ")j 

> 

> 

> 

> 

code 

candidates: 


b.ml( ) ; 
c .m2  ( ) ; 
a, m3  ( ) ; 

C . ml  ( ) ; 
C.m2() ; 
C.m3( ) ; 

a.  ml  ( ) ; 

b. m2  ( ) ; 

c . m3  ( ) ; 

a2 .ml  () ; 
a2 .m2  ( ) ; 
a2 .m3 ( ) ; 


> 

> 

> 

> 


output: 

A's  ml,  A's 
B's  ml,  A's 
A's  ml , B's 
B's  ml,  A's 
B's  ml,  C ' s 
B's  ml,  A's 

A's  ml,  A's 


m2 , 

C's 

m3. 

6 

m2. 

A'S 

m3. 

m2 , 

A's 

m3. 

m2, 

C's 

m3, 

13 

m2 , 

A'S 

m3 , 

m2 , 

C's 

m3, 

6 

m2 , 

C's 

m3 , 

13 
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Which  of  the  A -B  pairs  of  methods  listed  on  the  right,  if 
inserted  into  the  classes  on  the  left,  would  compile  and 
produce  the  output  shown?  (The  A method  inserted  into 
class  Monster,  the  B method  inserted  into  class  Vampire.) 


public  class  MonsterTestDrive  { 

public  static  void  main (String  {]  args)  { 
Monster  (]  ma  = new  Monster[3]; 
ma[0j  = new  Vampire(); 
ma[l]  = new  Dragon(); 
ma[2]  = new  Monster(); 
for(int  x = 0;  x < 3;  x++)  { 
ma[x) . frighten (x) ; 

> 

> 

> 

class  Monster  { 

Q 


1 

o 


o 


boolean  frighten (int  d)  { 

System-out .println ( "arrrgh") ; 
return  true; 

) 

boolean  frighten (int  x)  { 

System. out . println ( "a  bite?"); 
return  false; 

> 


2 

o 


o 


boolean  frighten(int  x)  { 

System. out. println( "arrrgh" ] ; 
return  true; 

} 

int  frighten (int  f)  { 

System-out .println ( "a  bite?"); 

return  1 ; 

> 


class  Vampire  extends  Monster  { 

o 

> 


class  Dragon  extends  Monster  { 
boolean  frighten(int  degree)  { 

System. out-println( "breath  fire" ) ; 
return  true; 


> 

} 


Fta  tdfl  WWo*  SzwYoi/stf 


* java  MonsterTestDrive 
a bite? 
bieath  fire 
arrrgh 


3 

o 


boolean  frighten(int  x)  { 

System. out .println ("arrrgh" ) ; 
return  false; 


Q 


_> 

boolean  scare (int  x)  { 

System. out-println( "a  bite?"); 

return  true; 


} 


4 

o 


o 


boolean  frighten (int  z)  { 

System. out -println ( "arrrgh" ) ; 
return  true; 

} 

boolean  f righten(byte  b)  { 

System. out. println("a  bite?"); 

return  true; 

) 
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Pool  Puzzle 


Your  Job  is  to  take  code  snippets  from  the  pool  and  place  them  into 
the  blank  lines  In  the  code. You  may  use  the  same  snippet  more 
than  once,  and  you  might  not  need  to  use  all  the  snippets.  Your 
goal  is  to  make  a set  of  classes  that  will  compile  and  run  together 
as  a program.  Don't  be  fooled  - this  one's  harder  than  it  looks. 


public  class  Rowboat 
public  


f 


rowTheBoat( ) { 


System* out. print ("stroke  natasha") ; 


} 


public  class 


private  int 
void 


) < 


length  = len; 


} 


public  int  getLength()  { 


> 

public 


move ( ) { 

System  * out . print  ( " " } ; 


public  class  TestBoats  { 


main(String[ ] args){ 


bl  = new  Boat ( ) ; 

Sailboat  b2  = new  (); 


Rowboat 


= new  Rowboat ( ) ; 


b2*aetLength(32) ; 

bl. (); 

b3. (); 

.move( ) ; 


} 


} 


public  class 
public  


.o  < 


Sys  tem . out . print  ( ‘ 


Boat  { 


OUTPUT: 


drift  drift  hoist  sail 


Rowboat 

Sailboat 


subclasses 


extends 


Boat 


Testboats  . Ifr 

Int  len  dmt  hoist  sail 

stroke  natasha 

u bl  int  String  move 

I tb,  Int  bB  void  public 


return 
continue 
bl  break 

b3  length 
len 


rowTheBoat 


setLength 


int 


static 


getLength 


private 


int  b2 
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BE  tke  CoffiJ fler 

Set  1 will  work 


Excise 

Solutions 


/ 


Set  2 will  not  compile  because  of  Vampire's  return 
type  (Int). 

The  Vampire's  frightenO  method  (B)  is  not  a legal 
override  OR  overload  of  Monster's  frighten()  method, 
Changing  ONLY  the  return  type  Is  not  enough 
to  make  a valid  overload,  and  since  an  int  is  not 
compatible  with  a boolean,  the  method  is  not  a valid 
override.  (Remember,  if  you  change  ONLY  the  return 
type,  it  must  be  to  a return  type  that  Is  compatible 
with  the  superclass  version's  return  type,  and  then  it's 
an  override. 

Sets  3 and  4 will  compile,  but  produce: 

arrrgh 

breath  fire 

arrrgh 

Remember,  class  Vampire  did  not  override  class 
Monster's  frighten()  method.  (The  frighten()  method 
in  Vampire's  set  4 takes  a byte,  not  on  int.) 


code 

candidates: 

Mixed 

MeSsogcS 


b.m2  ( ) 7 
C.m3(  ) ; 

a2  -ml  ( ) ji 
&2 .m2  ( ) ; 
a2 .m3  ( ) ; 


B'a  ml,  AJs  m2,  C'a  m3, 
A's  ml,  A's  m2,  C's  m3, 


6 


13 

6 

13 
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public  class  Rowboat  extends  Boat  { 
public  void  rowTheBoat ( ) { 

System. out.print( "stroke  natasha") ; 

> 

> 

public  class  Boat  { 
private  int  length  ; 
public  void  setLength  < int  len  ) { 

length  = len; 

> 

public  int  getLength()  { 

return  length  ? 

> 

public  void  move  ( ) { 

System,  out . print  ( "drift  " ) ; 

> 


public  class  TestBoats  { 

public  Static  void  main ( String!  ] args ) { 
Boat  bl  = new  Boat<); 

Sailboat  b2  = new  Sailboat(); 
Rowboat  b3  = new  Rowboat ( ) ; 
b2. setLength ( 32 ) ; 
bl.move( ) ? 
b3.move(  ) ; 
b2 . move ( ) ; 

> 

> 

public  class  Sailboat  extends  Boat  { 
public  void  movet ) { 

Sy stem. out. print ( "hoist  Sail  ") ; 

> 

> 


drift  drift  hoist  sail 
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Serious  Polymorphism 


Inheritance  is  just  the  beginning.  To  exploit  polymorphism,  we  need  interfaces 
(and  not  the  GUI  kind).  We  need  to  go  beyond  simple  inheritance  to  a level  of  flexibility  and 
extensibility  you  can  get  only  by  designing  and  coding  to  interface  specifications.  Some  of  the 
coolest  parts  of  Java  wouldn't  even  be  possible  without  interfaces,  so  even  if  you  don't  design 
with  them  yourself,  you  still  have  to  use  them.  But  you'll  want  to  design  with  them.  You'll  need 
to  design  with  them.  You'll  wonder  how  you  ever  lived  without  them.  What's  an  interface?  It's 
a 1 00%  abstract  class.  What's  an  abstract  class?  It's  a class  that  can't  be  instantiated.  What's  that 
good  for?  You'll  see  in  just  a few  moments.  But  if  you  think  about  the  end  of  the  last  chapter, 
and  how  we  used  polymorphic  arguments  so  that  a single  Vet  method  could  take  Animal 
subclasses  of  all  types,  well,  that  was  just  scratching  the  surface.  Interfaces  are  the  poly  in 
polymorphism. The  ab  in  abstract.The  caffeine  in  Java. 
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designing  with  inheritance 


Pid  we  forget  about  something 
when  we  designed  this? 

The  class  structure  isn’t  too  bad.  We’ve  designed 
it  so  that  duplicate  code  is  kept  to  a minimum, 
and  we’ve  overridden  the  methods  that  we  think 
should  have  subclass-specific  implementations. 
We’ve  made  it  nice  and  flexible  from  a 
polymorphic  perspective,  because  we  can  design 
Animal-using  programs  with  Animal  arguments 
(and  array  declarations),  so  that  any  Animal 
subtype — including  those  we  never  imagined  at  the 
time  we  wrote  our  code — can  be  passed  in  and  used 
at  runtime.  We’ve  put  the  common  protocol  for 
all  Animals  (the  four  methods  that  we  want  the 
world  to  know  all  Animals  have)  in  the  Animal 
superclass,  and  we’re  ready  to  start  making  new 
Lions  and  Tigers  and  Hippos. 


Animal 


picture 

food 

hunger 

boundaries 

location 


makeNoise() 

eat() 


sleep() 

roam() 
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We  know  we  can  say: 

Wolf  aWolf  = new 


A l/Vol-P  v-e-Perende  to 
l/Vol-P  objedt- 


These  two  are  the  same  type- 


And  we  know  we  can  say: 


Animal  aHippo  = new 


Animal  re-Perende  to 
a Hippo  objedt- 


Hippo  ( ) ; 


These  two  are  MOT  the  same  type- 


But  here’s  where  it  gets  weird: 

Animal  anim  = new  Animal (); 


Animal  re-Perende  to 
an  Animal  objedt- 


what  the  hedk  does  an  Animal  objedt  look  like? 
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when  objects  go  bad 


What  does 
look  like? 


scary  objects 


a new  Animal() 


What  are  the  instance  variable  values? 

Some  classes  just  should  not  be 
instantiated! 

It  makes  sense  to  create  a Wolf  object  or  a Hippo 
object  or  a Tiger  object,  but  what  exactly  is  an 
Animal  object?  What  shape  is  it?  What  color,  size, 
number  of  legs... 

Trying  to  create  an  object  of  type  Animal  is  like  a 
nightmare  Star  Trek™  transporter  accident.  The 
one  where  somewhere  in  the  beam-me-up  process 
something  bad  happened  to  the  buffer. 

But  how  do  we  deal  with  this?  We  need  an  Animal 
class,  for  inheritance  and  polymorphism.  But  we 
want  programmers  to  instantiate  only  the  less 
abstract  subclasses  of  class  Animal,  not  Animal  itself. 
We  want  Tiger  objects  and  Lion  objects,  not  Animal 
objects. 

Fortunately,  there’s  a simple  way  to  prevent  a class 
from  ever  being  instantiated.  In  other  words,  to  stop 
anyone  from  saying  “new”  on  that  type.  By  marking 
the  class  as  abstract,  the  compiler  will  stop  any 
code,  anywhere,  from  ever  creating  an  instance  of 
that  type. 


You  can  still  use  that  abstract  type  as  a reference  type. 
In  fact, that’s  a big  part  of  why  you  have  that  abstract 
class  in  the  first  place  (to  use  it  as  a polymorphic 
argument  or  return  type,  or  to  make  a polymorphic 
array) . 

When  you’re  designing  your  class  inheritance 
structure,  you  have  to  decide  which  classes  are 
abstract  and  which  are  concrete.  Concrete  classes  are 
those  that  are  specific  enough  to  be  instantiated.  A 
concrete  class  just  means  that  it’s  OK  to  make  objects 
of  that  type. 

Making  a class  abstract  is  easy — put  the  keyword 
abstract  before  the  class  declaration: 


abstract 


class  Canine  extends  Animal  { 


public  void  roam()  { } 


} 
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The  compiler  won't  let  you  instantiate 
an  abstract  class 


An  abstract  class  means  that  nobody  can  ever  make  a new 
instance  of  that  class.  You  can  still  use  that  abstract  class  as  a 
declared  reference  type,  for  the  purpose  of  polymorphism,  but 
you  don’t  have  to  worry  about  somebody  making  objects  of  that 
type.  The  compiler  guarantees  it. 


abstract 


public  class  Canine  extends  Animal 


public  void  roam()  { } 


} 


public  class  MakeCanine 
public  void  go()  { 
Canine  c; 
c = new  Dog() 


.s  o*,  V*ta«e  "T ta" 

V?  tfce  ^crCAa 


c = new  Canine ( ) ; 


c.roam()  ; 


File  Edit  Window  Help  BeamMellp 


% j avac  MakeCanine . j ava 

MakeCanine . j ava : 5 : Canine  is  abstract; 
cannot  be  instantiated 
c = new  Canine ( ) ; 

A 

1 error 


An  abstract  class  has  virtually*  no  use,  no  value,  no 
purpose  in  life,  unless  it  is  extended. 

With  an  abstract  class,  the  guys  doing  the  work  at  runtime 
are  instances  of  a subclass  of  your  abstract  class. 


■*There  is  an  exception  ■to  -this— an  abstract  class  can 
have  static  members  (see  chapter  10). 
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Abstract  vs.  Concrete 


abs-brdd-t 


A class  that’s  not  abstract  is  called 
a concrete  class.  In  the  Animal 
inheritance  tree,  if  we  make 
Animal,  Canine,  and  Feline 
abstract,  that  leaves  Hippo,  Wolf, 
Dog,  Tiger,  Lion,  and  Cat  as  the 
concrete  subclasses. 

Flip  through  the  Java  API  and 
you’ll  find  a lot  of  abstract  classes, 
especially  in  the  GUI  library.  What 
does  a GUI  Component  look 
like?  The  Component  class  is  the 
superclass  of  GUI-related  classes 
for  things  like  buttons,  text  areas, 
scrollbars,  dialog  boxes,  you  name 
it.  You  don’t  make  an  instance  of 
a generic  Component  and  put  it  on 
the  screen,  you  make  a JButton.  In 
other  words,  you  instantiate  only  a 
concrete  subclass  of  Component,  but 
never  Component  itself. 


abstract  or  concrete? 


How  do  you  know  when  a class  should  be 
abstract?  Wine  is  probably  abstract.  But  what 
about  Red  and  White ? Again  probably  abstract 
(for  some  of  us,  anyway).  But  at  what  point  in  the 
hierarchy  do  things  become  concrete? 

Do  you  make  PinotNoir  concrete,  or  is  it  abstract 
too?  It  looks  like  the  Camelot  Vineyards  1 997 
Pinot  Noir  is  probably  concrete  no  matter  what. 
But  how  do  you  know  for  sure? 

Look  at  the  Animal  inheritance  tree  above.  Do  the 
choices  we've  made  for  which  classes  are  abstract 
and  which  are  concrete  seem  appropriate? 

Would  you  change  anything  about  the  Animal 
inheritance  tree  (other  than  adding  more  Animals, 
of  course)? 
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Abstract  methods 


Besides  classes,  you  can  mark  methods  abstract,  too.  An  abstract 
class  means  the  class  must  be  extended ; an  abstract  method  means 
the  method  must  be  overridden.  You  might  decide  that  some  (or  all) 
behaviors  in  an  abstract  class  don’t  make  any  sense  unless  they’re 
implemented  by  a more  specific  subclass.  In  other  words,  you  can’t 
think  of  any  generic  method  implementation  that  could  possibly  be 
useful  for  subclasses.  What  would  a generic  eat()  method  look  like? 

An  abstract  method  has  no  body! 

Because  you’ve  already  decided  there  isn’t  any  code  that  would  make 
sense  in  the  abstract  method,  you  won’t  put  in  a method  body.  So  no 
curly  braces — just  end  the  declaration  with  a semicolon. 


public 


abstract 


void  eat() ; 


Ho  metWW'f!  / 

U>-t^asen' 


If  you  declare  an  abstract  method,  you  MUST 
mark  the  class  abstract  as  well.  You  can’t  have 
an  abstract  method  in  a non-abstract  class. 

If  you  put  even  a single  abstract  method  in  a class,  you  have  to 
make  the  class  abstract.  But  you  can  mix  both  abstract  and  non- 
abstract methods  in  the  abstract  class. 


j-tJiereigraJio 

Dumb  Questions 


v;  What  is  the  point  of  an  abstract  method?  I thought 
the  whole  point  of  an  abstract  class  was  to  have  common 
code  that  could  be  inherited  by  subclasses. 

Inheritable  method  implementations  (in  other  words, 
methods  with  actual  bodies)  are  A Good  Thing  to  put  in  a 
superclass.  When  it  makes  sense.  And  in  an  abstract  class,  it 
often  doesn't  make  sense,  because  you  can't  come  up  with 
any  generic  code  that  subclasses  would  find  useful. The 
point  of  an  abstract  method  is  that  even  though  you  haven't 
put  in  any  actual  method  code,  you've  still  defined  part  of 
the  protocol  for  a group  of  subtypes  (subclasses). 


Which  is  good  because... 


Polymorphism!  Remember,  what  you  want  is  the 
ability  to  use  a superclass  type  (often  abstract)  as  a method 
argument,  return  type,  or  array  type.That  way,  you  get  to 
add  new  subtypes  (like  a new  Animal  subclass)  to  your 
program  without  having  to  rewrite  (or  add)  new  methods 
to  deal  with  those  new  types.  Imagine  how  you'd  have  to 
change  the  Vet  class,  if  it  didn't  use  Animal  as  its  argument 
type  for  methods.  You'd  have  to  have  a separate  method 
for  every  single  Animal  subclass!  One  that  takes  a Lion,  one 
that  takes  a Wolf,  one  that  takes  a...  you  get  the  idea.  So  with 
an  abstract  method,  you're  saying, "All  subtypes  of  this  type 
have  THIS  method. "for  the  benefit  of  polymorphism. 
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you  must  implement  abstract  methods 


You  MUST  implement  all  abstract  methods 


Implementing  an  abstract 
method  is  just  like 
overriding  a method. 


I have  wonderful  news, 
mother.  Joe  finally  implemented 
all  his  abstract  methods!  Now 
everything  is  working  just  the 
7 way  we  planned...  ^ 


Abstract  methods  don’t  have  a body;  they  exist  solely  for  polymorphism.  That 
means  the  first  concrete  class  in  the  inheritance  tree  must  implement  all  abstract 
methods. 

You  can,  however,  pass  the  buck  by  being  abstract  yourself.  If  both  Animal  and 
Canine  are  abstract,  for  example,  and  both  have  abstract  methods,  class  Canine 
does  not  have  to  implement  the  abstract  methods  from  Animal.  But  as  soon  as  we 
get  to  the  first  concrete  subclass,  like  Dog,  that  subclass  must  implement  all  of  the 
abstract  methods  from  both  Animal  and  Canine. 

But  remember  that  an  abstract  class  can  have  both  abstract  and  non-abstract 
methods,  so  Canine,  for  example,  could  implement  an  abstract  method  from 
Animal,  so  that  Dog  didn’t  have  to.  But  if  Canine  says  nothing  about  the  abstract 
methods  from  Animal,  Dog  has  to  implement  all  of  Animal’s  abstract  methods. 

When  we  say  “you  must  implement  the  abstract  method”,  that  means  you  must 
provide  a body.  That  means  you  must  create  a non-abstract  method  in  your  class 
with  the  same  method  signature  (name  and  arguments)  and  a return  type  that  is 
compatible  with  the  declared  return  type  of  the  abstract  method.  What  you  put  in 
that  method  is  up  to  you.  All  Java  cares  about  is  that  the  method  is  there,  in  your 
concrete  subclass. 
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Abstract  vs.  Concrete  Classes 

Let's  put  all  this  abstract  rhetoric  into  some  concrete  use.  In  the  middle 
column  we've  listed  some  classes.  Your  job  is  to  imagine  applications 
where  the  listed  class  might  be  concrete,  and  applications  where  the  listed 
class  might  be  abstract.  We  took  a shot  at  the  first  few  to  get  you  going. 

For  example,  class  Tree  would  be  abstract  in  a tree  nursery  program,  where 
differences  between  an  Oak  and  an  Aspen  matter.  But  in  a golf  simulation 
program,  Tree  might  be  a concrete  class  (perhaps  a subclass  of  Obstacle), 
because  the  program  doesn't  care  about  or  distinguish  between  different 
types  of  trees.  (There's  no  one  right  answer;  it  depends  on  your  design.) 


Concrete 


Sample  class  Abstract 


golf  course  simulation 


satellite  photo  application 


Tree  tree  nursery  application 

House  architect  application 


Town 


Football  Player  coaching  application 


Chair 


Customer 


Sales  Order 


Book 


Store 


Supplier 
Golf  Club 


Carburetor 


Oven 
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Polymorphism  in  action 

Let’s  say  that  we  want  to  write  our  own  kind  of  list  class,  one  that  will  hold 
Dog  objects,  but  pretend  for  a moment  that  we  don’t  know  about  the 
ArrayList  class.  For  the  first  pass,  we’ll  give  it  just  an  add()  method.  We’ll  use 
a simple  Dog  array  (Dog  [] ) to  keep  the  added  Dog  objects,  and  give  it  a 
length  of  5.  When  we  reach  the  limit  of  5 Dog  objects,  you  can  still  call  the 
add()  method  but  it  won’t  do  anything.  If  we’re  not  at  the  limit,  the  add() 
method  puts  the  Dog  in  the  array  at  the  next  available  index  position,  then 
increments  that  next  available  index  (nextlndex) . 


Building  our  own  Dog-specific  list 

(Perhaps  the  world’s  worst  attempt  at  making  our 
own  ArrayList  kind  of  class,  from  scratch.) 


MyDogList 


Dog[]  dogs 
int  nextlndex 


add(Dog  d) 


public  class  MyDogList  { 

private  Dog  []  dogs  = new  Dog [5] ; 
private  int  nextlndex  = 0 ; 


VVe'll  mOronewt  tw«s  eath 
•time  a r\w  ,s  a<^e<i 


public  void  add (Dog  d)  { 

if  (nextlndex  < dogs. length)  { 
dogs [nextlndex]  = d; 

System. out .println ("Dog  added  at 
nextlndex++ ; i 

i 


|Jf  yieVe  not  already  at  the 
ot  the  doy  away  add  the 
and  frint  a message- 


+ nextlndex) ; 


} 
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Uh'oh  now  we  need  to  keep  Cats,  too. 

We  have  a few  options  here: 

1)  Make  a separate  class,  MyCatList,  to  hold  Cat  objects.  Pretty  clunky. 

2)  Make  a single  class,  DogAndCatList,  that  keeps  two  different  arrays  as  instance 
variables  and  has  two  different  add()  methods:  addCat(Cat  c)  and  addDog(Dog 
d) . Another  clunky  solution. 

3)  Make  heterogeneous  AnimalList  class,  that  takes  any  kind  of  Animal  subclass 
(since  we  know  that  if  the  spec  changed  to  add  Cats,  sooner  or  later  we’ll  have 
some  other  kind  of  animal  added  as  well).  We  like  this  option  best,  so  let’s  change 
our  class  to  make  it  more  generic,  to  take  Animals  instead  of  just  Dogs.  We’ve 
highlighted  the  key  changes  (the  logic  is  the  same,  of  course,  but  the  type  has 
changed  from  Dog  to  Animal  everywhere  in  the  code. 


— 

MyAnimalList 


Animal[]  animals 
int  nextlndex 


add(Animal  a) 


Building  our  own  Animal-specific  list 


public  class  MyAnimalList  { 


private  Animal []  animals  = new  Animal [5] ; 
private  int  nextlndex  = 0 ; 


public  void  add (Animal  a)  { 

if  (nextlndex  < animals . length)  { 
animals [nextlndex]  = a; 

Sys  tern . out . prin tin ( "Animal  added  at 
nextlndex++ ; 


• ,* /,Ve  »ot  w*®*  3 
4 A*"'"3'  p , ’ r tyo t A*'1"'3'- 

■ ‘S£&% tZd’*'  arr 


+ nextlndex) ; 


} 


} 


} 


public  class  AnimalTestDrive{ 

public  static  void  main  (String []  args)  { 
MyAnimalList  list  = new  MyAnimalList () ; 
Dog  a = new  Dog ( ) ; 

Cat  c = new  Cat ( ) ; 
list. add (a) ; 
list. add (c) ; 

} 

} 


% java  AnimalTes tDrive 
Animal  added  at  0 
Animal  added  at  1 
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the  ultimate  superclass:  Object 


What  about  Non-Animals?  Why  not  make 
a class  generic  enough  to  take  anything? 


boolean  rem°Vef^^gtC^e  index  parameter-  Returns 


'true 


You  know  where  this  is  heading.  We  want  to  change  the 
type  of  the  array,  along  with  the  add()  method  argument,  to 
something  above  Animal.  Something  even  more  generic,  more  (3) 

abstract  than  Animal.  But  how  can  we  do  it?  We  don’t  have  a 
superclass  for  Animal. 

Then  again,  maybe  we  do...  r Array 

Remember  those  methods  of  ArrayList? 

Look  how  the  remove,  contains,  and 
indexOf  method  all  use  an  object  of  type... 

Object! 

Every  class  in  Java  extends 
class  Object. 

Class  Object  is  the  mother  of  all  classes;  it’s 
the  superclass  of  everything. 

Even  if  you  take  advantage  of  polymorphism, 
you  still  have  to  create  a class  with  methods 
that  take  and  return  your  polymorphic  type. 

Without  a common  superclass  for  everything 
in  Java,  there ’d  be  no  way  for  the  developers 
of  Java  to  create  classes  with  methods  that 
could  take  your  custom  types...  types  they  never 
knew  about  when  they  wrote  the  ArrayList  class. 

So  you  were  making  subclasses  of  class  Object 
from  the  very  beginning  and  you  didn’t  even 
know  it.  Every  class  you  write  extends  Object , 
without  your  ever  having  to  say  it.  But  you  can 
think  of  it  as  though  a class  you  write  looks  like 
this: 

public  class  Dog  extends  Object  { } 

But  wait  a minute,  Dog  already  extends  something,  Canine. 

That’s  OK.  The  compiler  will  make  Canine  extend  Object 
instead.  Except  Canine  extends  Animal.  No  problem,  then  the 
compiler  will  just  make  Animal  extend  Object. 

Any  class  that  doesn’t  explicitly  extend  another 
class,  implicitly  extends  Object. 

So,  since  Dog  extends  Canine,  it  doesn’t  directly  extend  Object 
(although  it  does  extend  it  indirectly),  and  the  same  is  true 
for  Canine,  but  Animal  does  directly  extend  Object. 


OVseare  f^a 
ave  "l0're' 


boolean  conta'"tS^^  amath  fo!  the  object  parameter. 

Returns 'true' inheres 

boo£"^ 

boolean  (returns ’true'). 


Adds  the 

II  more 


of  the  A'-a'/U.st  -etto*  ““ 


Tate  1"“,+ 

wltw»ate  W r ,s  a's„Wa«  4 Oh)«t, 

methods  atUal  7 ,1  £or  „onn  this 

tVie  tull  stor-7  a little  later- 
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So  what's  in  this  ultra-super-wegaclass  Object? 


If  you  were  Java,  what  behavior  would  you  want  every 
object  to  have?  Hmmmm...  let’s  see...  how  about  a 
method  that  lets  you  find  out  if  one  object  is  equal 
to  another  object?  What  about  a method  that  can 
tell  you  the  actual  class  type  of  that  object?  Maybe  a 
method  that  gives  you  a hashcode  for  the  object,  so 
you  can  use  the  object  in  hash  tables  (we’ll  talk  about 
Java’s  hashtables  in  chapter  17  and  appendix  B). 

Oh,  here’s  a good  one — a method  that  prints  out  a 
String  message  for  that  object. 

And  what  do  you  know?  As  if  by  magic,  class  Object 
does  indeed  have  methods  for  those  four  things. 
That’s  not  all,  though,  but  these  are  the  ones  we 
really  care  about. 


SOME 

of  da*  Otytt- 


EWy  dlass  you  write  inherits  all  -the 
methods  o-f  dlass  0bjedt  The  diasses 
youve  written  inherited  methods  you 
didn't  even  know  you  had- 


(?)  equals(Object  o) 

Dog  a = new  Dog()  ; 
Cat  c = new  Cat()  ; 


(5)  hashCode() 

Cat  c = new  Cat()  ; 

Sys  tem . out . pr in tin ( c . hashCode ( ) ) ; 


if  (a. equals (c) ) { 

System. out .println ("true") ; 

} else  { 

System. out .println ("false") ; 

} 

TelU  vou t*K>  objedts  are 

donsidered  'e^val' 

about  what  ‘e«H'  really 

means  in  aypendi*  B) 


% java  TestObject 
false 


File  Edit  Window  Help  Drop 


% java  TestObject 
8202111 


(4)  toString() 

Cat  c = new  Cat()  ; 

Sys  tem . out . println ( c . toS  tr ing ( ) ) ; 


(|)  getClass() 

Cat  c = new  Cat()  ; 

System. out .println (c.getClass () ) ; 


dlass  that  objedt  was 

instantiated  £rom. 


Edit  Window  Help  Faint 


java  TestObject 
lass  Cat 


File  Edit  Window  Help  LapselntoComa 


% java  TestObject 
Cat@7d277f 


b a St™s 

, „*.<  of  tt.  *“ 

A**  '* 
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r^tliereiare  no 

Dumb  Questions 


Is  class  Object  abstract? 


No.  Well,  not  in  the  formal 
Java  sense  anyway.  Object  is  a 
non-abstract  class  because  it's 
got  method  implementation 
code  that  all  classes  can  inherit 
and  use  out-of-the-box,  without 
having  to  override  the  methods. 


Then  can  you  override 


the  methods  in  Object? 


Some  of  them.  But  some  of 
them  are  marked  final,  which 
means  you  can't  override  them. 
You're  encouraged  (strongly)  to 
override  hashCodeO,  equalsO, 
and  toStringO  in  your  own 
classes,  and  you'll  learn  how  to 
do  that  a little  later  in  the  book. 
But  some  of  the  methods,  like 
getClassO,  do  things  that  must 
work  in  a specific,  guaranteed 
way. 


VJl  If  ArrayList  methods  are 
generic  enough  to  use  Object, 
then  what  does  it  mean  to  say 
ArrayList<DotCom>?  I thought 
I was  restricting  the  ArrayList  to 
hold  only  DotCom  objects? 

You  were  restricting  it. 

Prior  to  Java  5.0,  ArrayLists 
couldn't  be  restricted. They 
were  all  essentially  what  you 
get  in  Java  5.0  today  if  you  write 
ArrayList<Object>.  In  other 
words,  an  ArrayList  restricted 
to  anything  that's  an  Object, 
which  means  any  object  in  Java, 
instantiated  from  any  class  type! 
We'll  cover  the  details  of  this  new 
<type>  syntax  later  in  the  book. 


vL:  OK,  back  to  class  Object 
being  non-abstract  (so  I guess 
that  means  it's  concrete),  HOW 
can  you  let  somebody  make  an 
Object  object?  Isn't  that  just 
as  weird  as  making  an  Animal 
object? 

Good  question!  Why  is 
it  acceptable  to  make  a new 
Object  instance?  Because 
sometimes  you  just  want  a 
generic  object  to  use  as,  well,  as 
an  object.  A lightweight  object. 

By  far,  the  most  common  use  of 
an  instance  of  type  Object  is  for 
thread  synchronization  (which 
you'll  learn  about  in  chapter  15). 
For  now,  just  stick  that  on  the 
back  burner  and  assume  that 
you  will  rarely  make  objects  of 
type  Object,  even  though  you 
can. 

Q?  So  is  it  fair  to  say  that  the 
main  purpose  for  type  Object 
is  so  that  you  can  use  it  for  a 
polymorphic  argument  and 
return  type?  Like  in  ArrayList? 

-^1  The  Object  class  serves 
two  main  purposes:  to  act  as  a 
polymorphic  type  for  methods 
that  need  to  work  on  any  class 
that  you  or  anyone  else  makes, 
and  to  provide  real  method  code 
that  all  objects  in  Java  need  at 
runtime  (and  putting  them  in 
class  Object  means  all  other 
classes  inherit  them).  Some  of 
the  most  important  methods  in 
Object  are  related  to  threads, 
and  we'll  see  those  later  in  the 
book. 


vL:  If  it's  so  good  to  use 
polymorphic  types,  why 
don't  you  just  make  ALL  your 
methods  take  and  return  type 
Object? 

Ahhhh...  think  about  what 
would  happen.  For  one  thing, 
you  would  defeat  the  whole 
point  of  'type-safety',  one 
of  Java's  greatest  protection 
mechanisms  for  your  code.  With 
type-safety,  Java  guarantees  that 
you  won't  ask  the  wrong  object 
to  do  something  you  meant  to 
ask  of  another  object  type.  Like, 
ask  a Ferrari  (which  you  think  is  a 
Toaster)  to  cook  itself. 

But  the  truth  is,  you  don't  have 
to  worry  about  that  fiery  Ferrari 
scenario,  even  if  you  do  use 
Object  references  for  everything. 
Because  when  objects  are 
referred  to  by  an  Object 
reference  type,  Java  thinks  it's 
referring  to  an  instance  of  type 
Object.  And  that  means  the 
only  methods  you're  allowed  to 
call  on  that  object  are  the  ones 
declared  in  class  Object!  So  if 
you  were  to  say: 

Object  o = new  Ferrari () ; 
o.goFast() ; //Not  legal! 

You  wouldn't  even  make  it  past 
the  compiler. 

Because  Java  is  a strongly-typed 
language,  the  compiler  checks 
to  make  sure  that  you're  calling 
a method  on  an  object  that's 
actually  capable  of  responding. 

In  other  words, you  can  call  a 
method  on  an  object  reference 
only  if  the  class  of  the  reference 
type  actually  has  the  method. 
We'll  cover  this  in  much  greater 
detail  a little  later,  so  don't  worry 
if  the  picture  isn't  crystal  clear. 
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Using  polymorphic  references  of  type  Object  has  a price... 


Before  you  run  off  and  start  using  type  Object  for  all  your  ultra-flexible  argument  and  return 
types,  you  need  to  consider  a little  issue  of  using  type  Object  as  a reference.  And  keep  in  mind 
that  we’re  not  talking  about  making  instances  of  type  Object;  we’re  talking  about  making 
instances  of  some  other  type,  but  using  a reference  of  type  Object. 

When  you  put  an  object  into  an  ArrayList<Dog>,  it  goes  in  as  a Dog,  and  comes  out  as  a Dog: 

, Make  an  dedlared 

ArrayList<Dog>  myDogArrayList  = new  ArrayList<Dog>  ( ) ; ^-0  hold  objed-ts- 

Dog  aDog  = new  Dog  ( ) ; ^ — WVIake  3 Po<y 

myDogArrayList . add  (aDog)  ; Add  the  the  list  to 

Dog  d = myDogArrayList . get ( 0 ) ; 4 — (Think  o-C  it  as  though  the  ytO 

type  bet  awe  Y°u  u$ed 

But  what  happens  when  you  declare  it  as  ArrayList<Object>?  If  you  want  to  make  an  ArrayList 
that  will  literally  take  any  kind  of  Object,  you  declare  it  like  this: 


a new  Po?>  variable- 

method  dedaves  a P05  rctwrw 


Make  a*  A rraybist  dedlared 

ArrayList<Ob  ject>  myDogArrayList  = new  ArrayList<Ob  ject>  ( ) ; ^ ^ hold  any  type  o-C  Object 
Dog  aDog  = new  Dog  ( ) ; Make  a Pog  sie?s  a>.e  ^ same) 

myDogArrayList . add  (aDog)  ; £ — -Add  tbe  Pog  to  tbe  list-  j 


But  what  happens  when  you  try  to  get  the  Dog  object  and  assign  it  to  a Dog  reference? 


Dog  d = myDogArrayList. get  (0)  ; Won'i  t0"file"  When  Yow  use  ArrayList<%dt>,  tbe  get 0 method 

returns  type  Objedt-  The  Compiler  knows  only  that  the  objedt  inherits  -from 
Objedt  (somewhere  in  its  inheritande  tree)  but  it  doesn’t  know  it’s  a Pog  f| 


Everything  comes  out  of  an  ArrayList<Object>  as  a reference  of  type  Object,  regardless  of  what  the 
actual  object  is,  or  what  the  reference  type  was  when  you  added  the  object  to  the  list. 


The  objects  go  IN 
as  SoccerBall, 
Fish,  Guitar,  and 
Car. 


ArrayList<Object> 


But  they  come 
OUT  as  though 
they  were  of  type 

Object. 


Objects  come  out  of 
an  ArrayList<Object> 
acting  like  they’re 
generic  instances 
of  class  Object.  The 
Compiler  cannot 
assume  the  object 
that  comes  out  is  of 
any  type  other  than 
Object. 
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When  a Dog  loses  its  Dogness 


Whew  a Pog  won't  act  like  a Pog 

The  problem  with  having  everything  treated 
polymorphically  as  an  Object  is  that  the  objects 
appear  to  lose  (but  not  permanently)  their 
true  essence.  The  Dog  appears  to  lose  its  dogness. 
Let’s  see  what  happens  when  we  pass  a Dog  to 
a method  that  returns  a reference  to  the  same 
Dog  object,  but  declares  the  return  type  as  type 
Object  rather  than  Dog. 


BAP 


I \ 

public  void  go  ()  { a xjovV-!  ^ 

Dog  aDog  = new  Dog  ( > ; a ^ * etwrn 

Dog  sameDog  = getObject  (aDog)  ; 4r  rt  i to>  » \ ^ ass*^  t 

\ 

public  Object  getObject (Object  o)  { 
return  o;  r * - L, 


\VfcVe  veW7  le*>1'  N°te: 

vtt»™  t'rl<  J*  ■ , 0 ^ko(,  ,„ti  «ke»  >** 

tte  „ .W.U  ^,k™*k‘  * tta>,  a„  W4^ 


File  Edit  Window  Help  Remember 


DogPolyTest . java : 10 : incompatible  types 
found  : java . lang . Ob ject 
required:  Dog 

Dog  sameDog  = takeObjects (aDog) ; 
1 error  A 


The  eompilev  doesn  t know  that  the 
thing  returned  ( rom  the  method  is 
y anally  a Pog,  so  it  won  t let  you 
assign  it  to  a Pog  re-Cerenee.  (Youll 
see  why  on  the  next  pa$c) 


<$00P 

© 


public  void  go()  { 

Dog  aDog  = new  Dog() ; 

Object  sameDog  = getObject (aDog) ; 


public  Object  getObject (Object  o)  { 
return  o; 


This  works  (although  it  may  not  be  very 
/ use-Pul,  as  you  II  see  in  a moment)  because  you 
£an  assign  ANYTHIN^  to  a reterenee  ot  type 
Objeet,  si  nee  every  elass  passes  the  |S -A  test 
■for  Objedt-  Every  objedt  in  Java  is  an  ins-fcande 
of  -type  Objedt,  bedause  every  dlass  in  Java  bas 
Objedt  at  the  top  of  its  inheritande  tree- 


} 
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Objects  don't  bark. 

So  now  we  know  that  when  an  object  is 
referenced  by  a variable  declared  as  type 
Object,  it  can’t  be  assigned  to  a variable 
declared  with  the  actual  object’s  type. 
And  we  know  that  this  can  happen  when 
a return  type  or  argument  is  declared 
as  type  Object,  as  would  be  the  case, 
for  example,  when  the  object  is  put 
into  an  ArrayList  of  type  Object  using 
ArrayList<Object>.  But  what  are  the 
implications  of  this?  Is  it  a problem  to 
have  to  use  an  Object  reference  variable 
to  refer  to  a Dog  object?  Let’s  try  to  call 
Dog  methods  on  our  Dog-That-Compiler- 
Thinks-Is-An-Obj  ect: 


Men  you  get  an  objedt  re-Perende  -Prom 
an  /WayList<Objedt>  (or  any  method 
that  dedlares  Objedt  as  the  return  type), 
it  domes  badk  as  a polymorphid  re-P erende  ' 
type  O' P Objedt-  So  you  have  an  Objedt 
rrfej rende  to  (in  this  dase)  a Dog  instande- 


Won  t 


ild! 


Object  o = al . get (index) ; 
int  i = o .hashCode  ()  ; 4^ 

c . bark ( ) ; ^ 


eO 

itVoA  or- 


-that  ** 


Can  t do  thi s//  Tbe  Objedt  dlass  bas  no  idea  what 
it  means  to  barkO.  Even  though  ^0U  know  it*s 
really  a Dog  at  that  inde%>  tbe  dompiler  doesn’t-. 


The  compiler  decides  whether 
you  can  call  a method  based 
on  the  reference  type,  not  the 
actual  object  type. 


Even  if  you  know  the  object  is  capable 
(“...but  it  really  is  a Dog,  honest...”),  the 
compiler  sees  it  only  as  a generic  Object. 
For  all  the  compiler  knows,  you  put  a 
Button  object  out  there.  Or  a Microwave 
object.  Or  some  other  thing  that  really 
doesn’t  know  how  to  bark. 

The  compiler  checks  the  class  of  the 
reference  type — not  the  object  type — to 
see  if  you  can  call  a method  using  that 
reference. 


°°9  ob  '^ 


Object 

equalsQ 
getClass() 
hashCode()  . 
toStringQ  ^ 


Tbe  method  youVe  dal  ling  on  a 
re-Perende  MUST  be  in  tbe  dlass  o-P 
that  re-Perende  type-  Doesn't  matter 
what  tbe  adtual  objedt  is. 

o . hashCode ( ) ; 


Tbe  wo"  re-Perende  was  dedlared  as  type 
Objedt^  so  you  dan  dal  I methods  only  i-P 
those  methods  are  in  dlass  Objedt-. 
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objects  are  Objects 


(ret  in  touch  with  your  inner  Object. 

An  object  contains  everything  it  inherits  from  each  of  its 
superclasses.  That  means  every  object — regardless  of  its 
actual  class  type — is  also  an  instance  of  class  Object. That 
means  any  object  in  Java  can  be  treated  not  just  as  a Dog, 
Button,  or  Snowboard,  but  also  as  an  Object.  When  you 
say  new  Snowboard  ( ) , you  get  a single  object  on  the 
heap — a Snowboard  object — but  that  Snowboard  wraps 
itself  around  an  inner  core  representing  the  Object 
(capital  “O”)  portion  of  itself. 


Snowboard 

equals() 
getClass()  / 
hashCode()  / 
toString()  J 

turn() 

shredf) 

getAir() 

loseControlQ 


There  is  oy\  ly  0MB-  objedt  oy\  the  heap  here-  A Snowboard 
objedt-  But  it  donta’ms  both  the  Snowboard  dlass  parts  ot 
itsel-f  a*d  the  ^bjedt  dlass  parts  ot  itsel-f . 
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‘Polymorphism’  means 
‘many  forms’. 

You  can  treat  a Snowboard  as  a 
Snowboard  or  as  an  Object. 

If  a reference  is  like  a remote  control,  the 
remote  control  takes  on  more  and  more  buttons 
as  you  move  down  the  inheritance  tree.  A 
remote  control  (reference)  of  type  Object  has 
only  a few  buttons — the  buttons  for  the  exposed 
methods  of  class  Object.  But  a remote  control 
of  type  Snowboard  includes  all  the  buttons  from 
class  Object,  plus  any  new  buttons  (for  new 
methods)  of  class  Snowboard.  The  more  specific 
the  class,  the  more  buttons  it  may  have. 

Of  course  that’s  not  always  true;  a subclass  might 
not  add  any  new  methods,  but  simply  override 
the  methods  of  its  superclass.  The  key  point  is 
that  even  if  the  object  is  of  type  Snowboard,  an 
Object  reference  to  the  Snowboard  object  can’t  see 
the  Snowboard-specific  methods. 


Snowboard 
Object  O = 


When  you  put 
an  object  in  an 
ArrayList<Object>,  you 
can  treat  it  only  as  an 
Object,  regardless  of 
the  type  it  was  when 
you  put  it  in. 

When  you  get  a 
reference  from  an 
ArrayList<Object>,  the 
reference  is  always  of 
type  Object. 

That  means  you  get  an 
Object  remote  control. 


The  Snowboard  remote  dontrol 
(rePerende)  has  move  buttons  "than 
an  Objedt  remote  dontrol-  The 
Snowboard  vemo-te  dan  see  the  -Pull 
Snowboardness  oP  the  Snowboard 
objedt-  It  dan  addess  all  the  methods 
in  Snowboard)  indluding  both  the 
inherited  Objedt  methods  and  the 
methods  -Prom  dlass  Snowboard- 


^H'boacd  °'°''0 


The  Objedt  rePerende  dan  see  only  the 
Objedt  parts  oP  the  Snowboard  objedt- 
It  dan  addess  only  the  methods  o-P  dlass 
Objedt-  It  has  Pewer  buttons  than  the 
Snowboard  remote  dontrol- 
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r 

Cast  the  so-called  'Object'  (but 
we  know  he's  actually  a Dog)  to 
tyr e Dog,  so  that  you  can  treat 
him  like  the  Dog  he  veally  is- 


Wait  a minute...  what  good 
is  a Dog  if  it  comes  out  of  an 
ArrayList<Object>  and  it  can't  do 
any  Dog  things?  There's  gotta  be  a 
way  to  get  the  Dog  back  to  a state 
of  Dogness... 


I hope  it  doesn't  hurt. 
And  what's  so  wrong  with 
staying  an  Object?  OK,  I can't 
fetch,  sure,  but  I can  give  you 
a real  nice  hashcode. 


Casting  an  object  reference 
back  to  its  real  type. 


It’s  really  still  a Dog  object , but  if  you  want  to  call 
Dog-specific  methods,  you  need  a reference  declared 
as  type  Dog.  If  you’re  sure * the  object  is  really  a 
Dog,  you  can  make  a new  Dog  reference  to  it  by 
copying  the  Object  reference,  and  forcing  that 
copy  to  go  into  a Dog  reference  variable,  using  a 
cast  (Dog) . You  can  use  the  new  Dog  reference  to 
call  Dog  methods. 


o = al . ere  t (index) 


*If  you’re  not  sure  it’s  a Dog,  you  can  use  the 
instanceof  operator  to  check.  Because  if 
you’re  wrong  when  you  do  the  cast,  you’ll  get  a 
ClassCastException  at  runtime  and  come  to  a 
grinding  halt. 


if  (o  instanceof  Dog)  { 
Dog  d = (Dog)  o; 

} 
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So  now  you’ve  seen  how  much  Java 
cares  about  the  methods  in  the 
class  of  the  reference  variable. 

You  can  call  a method  on  an  object  only  if 
the  class  of  the  reference  variable  has  that 
method. 


Think  of  the  public  methods  in  your  class  as 
your  contract,  your  promise  to  the  outside 
world  about  the  things  you  can  do. 


When  you  write  a class,  you  almost  always  expose  some 
of  the  methods  to  code  outside  the  class.  To  expose  a 
method  means  you  make  a method  accessible , usually  by 
marking  it  public. 

Imagine  this  scenario:  you’re  writing  code  for  a small 
business  accounting  program.  A custom  application 
for  “Simon’s  Surf  Shop”.  The  good  re- 
user that  you  are,  you  found  an  Account 
class  that  appears  to  meet  your  needs 
perfectly,  according  to  its  documentation, 
anyway.  Each  account  instance  represents 
an  individual  customer’s  account  with  the 
store.  So  there  you  are  minding  your  own 
business  invoking  the  credit( ) and  debit( ) 
methods  on  an  account  object  when  you  realize  you 
need  to  get  a balance  on  an  account.  No  problem — 
there’s  a getBalance()  method  that  should  do  nicely. 

Except...  when  you  invoke  the  getBalance()  method, 
the  whole  thing  blows  up  at  runtime.  Forget  the 
documentation,  the  class  does  not  have  that  method. 
Yikes! 

But  that  won’t  happen  to  you,  because  everytime  you 
use  the  dot  operator  on  a reference  (a.doStuff()),  the 
compiler  looks  at  the  reference  type  (the  type  ‘a’  was 
declared  to  be)  and  checks  that  class  to  guarantee  the 
class  has  the  method,  and  that  the  method  does  indeed 
take  the  argument  you’re  passing  and  return  the  kind  of 
value  you’re  expecting  to  get  back. 

Just  remember  that  the  compiler  checks  the  class  of  the 
reference  variable,  not  the  class  of  the  actual  object  at  the 
other  end  of  the  reference. 


Account 

debit(double  amt) 

credit(double  amt) 
double  getBalanceQ 
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What  if  you  weed  to  change 
the  contract? 


OK,  pretend  you’re  a Dog.  Your  Dog  class 
isn’t  the  only  contract  that  defines  who  you 
are.  Remember,  you  inherit  accessible  (which 
usually  means  public ) methods  from  all  of 
your  superclasses. 

True,  your  Dog  class  defines  a contract. 

But  not  all  of  your  contract. 

Everything  in  class  Canine  is  part  of  your 
contract. 

Everything  in  class  Animal  is  part  of  your 
contract. 

Everything  in  class  Object  is  part  of  your 
contract. 

According  to  the  IS-A  test,  you  are  each  of 
those  things — Canine,  Animal,  and  Object. 

But  what  if  the  person  who  designed  your 
class  had  in  mind  the  Animal  simulation 
program,  and  now  he  wants  to  use  you  (class 
Dog)  for  a Science  Fair  Tutorial  on  Animal 
objects. 

That’s  OK,  you’re  probably  reusable  for  that. 

But  what  if  later  he  wants  to  use  you  for  a 
PetShop  program?  You  don ’t  have  any  Pet 
behaviors.  A Pet  needs  methods  like  beFriendly() 
and  play(). 

OK,  now  pretend  you’re  the  Dog  class 
programmer.  No  problem,  right?  Just  add 
some  more  methods  to  the  Dog  class.  You 
won’t  be  breaking  anyone  else’s  code  by 
adding  methods,  since  you  aren’t  touching 
the  existing  methods  that  someone  else’s  code 
might  be  calling  on  Dog  objects. 

Can  you  see  any  drawbacks  to  that  approach 
(adding  Pet  methods  to  the  Dog  class)? 


r<5§!****^**  

Think  about  what  YOU  would  do  if  YOU  were 
the  Dog  class  programmer  and  needed  to 
modify  the  Dog  so  that  it  could  do  Pet  things, 
too.  We  know  that  simply  adding  new  Pet  be- 
haviors (methods)  to  the  Dog  class  will  work, 
and  won't  break  anyone  else's  code. 

But...  this  is  a PetShop  program.  It  has  more 
than  just  Dogs!  And  what  if  someone  wants 
to  use  your  Dog  class  for  a program  that  has 
wild  Dogs?  What  do  you  think  your  options 
might  be,  and  without  worrying  about  how 
Java  handles  things,  just  try  to  imagine  how 
you'd  like  to  solve  the  problem  of  modifying 
some  of  your  Animal  classes  to  include  Pet 
behaviors. 

Stop  right  now  and  think  about  it, 
before  you  look  at  the  next  page  where  we 
begin  to  reveal  everything. 

(thus  rendering  the  whole  exercise  completely  useless,  robbing 
you  of  your  One  Big  Chance  to  burn  some  brain  calories) 
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let's  explore  some  design  options 
for  reusing  some  of  our  existing 
classes  in  a PetShop  program. 

On  the  next  few  pages,  we’re  going  to  walk  through 
some  possibilities.  We’re  not  yet  worried  about 
whether  Java  can  actually  do  what  we  come  up  with. 
We’ll  cross  that  bridge  once  we  have  a good  idea  of 
some  of  the  tradeoffs. 


® Option  one 

We  take  the  easy  path,  and  put  pet 
methods  in  class  Animal. 

Pros: 

All  the  Animals  will  instantly  inherit 
the  pet  behaviors.  We  won't  have  to 
touch  the  existing  Animal  subclasses 
at  all,  and  any  Animal  subclasses 
created  in  the  future  will  also  get  to 
take  advantage  of  inheriting  those 
methods.  That  way,  class  Animal  can 
be  used  as  the  polymorphic  type  in 
any  program  that  wants  to  treat  the 
Animals  as  pets 

Cons: 

So...  when  was  the  last  time  you 
saw  a Hippo  at  a pet  shop?  Lion? 

Wolf?  Could  be  dangerous  to  give 
non-pets  pet  methods. 


Also,  we  almost  certainly  WILL 
have  to  touch  the  pet  classes 
like  Dog  and  Cat,  because  (in 
our  house,  anyway)  Dogs 
and  Cats  tend  to  imple- 
ment pet  behaviors 
VERY  differently. 


v a\\  ^ ^ 
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(D  Option  two 

We  start  with  Option  One,  putting  the  pet  methods 
in  class  Animal,  but  we  make  the  methods  abstract, 
forcing  the  Animal  subclasses  to  override  them. 

Pros: 

That  would  give  us  all  the  benefits  of  Option  One,  but  with- 
out the  drawback  of  having  non-pet  Animals  running  around 
with  pet  methods  (like  beFriendlyO).  All  Animal  classes 
would  have  the  method  (because  it's  in  class  Animal),  but 
because  it's  abstract  the  non-pet  Animal  classes  won't 
inherit  any  functionality.  All  classes  MUST  override  the 
methods,  but  they  can  make  the  methods  "do-nothings". 


out 


/ 


Cons: 

Because  the  pet  methods  in  the  Animal  class  are  all 
abstract,  the  concrete  Animal  subclasses  are  forced  to 
implement  all  of  them.  (Remember,  all  abstract  methods 
MUST  be  implemented  by  the  first  concrete  subclass 
down  the  inheritance  tree.)  What  a waste  of  time! 

You  have  to  sit  there  and  type  in  each  and  every 
pet  method  into  each  and  every  concrete  non- 
pet class,  and  all  future  subclasses  as  well. 

And  while  this  does  solve  the  problem  of 
non-pets  actually  DOING  pet  things 
(as  they  would  if  they  inherited  pet 
functionality  from  class  Animal),  the 
contract  is  bad.  Every  non- pet 
class  would  be  announcing  to  the 
world  that  it,  too,  has  those 
pet  methods,  even  though 
the  methods  wouldn't 
actually  DO  anything  I Llon 

when  called. 

This  approach  doesn't 
look  good  at  all.  It  just 
seems  wrong  to  stuff 
everything  into  class  Animal 
that  more  than  one  Animal  type 
might  need,  UNLESS  it  applies  to 
ALL  Animal  subclasses. 


Animal 

Hippo 

Canine 


iiger  J 
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© Option  three 

Put  the  pet  methods  ONLY  in  the 
classes  where  they  belong. 

Pros: 

No  more  worries  about  Hippos  greeting  you  at  the 
door  or  licking  your  face.  The  methods  are  where 
they  belong,  and  ONLY  where  they  belong.  Dogs  can 
implement  the  methods  and  Cats  can  implement  the 
methods,  but  nobody  else  has  to  know  about  them. 

Cons: 

Two  Big  Problems  with  this  approach.  First  off,  you'd 
have  to  agree  to  a protocol,  and  all  programmers  of 
pet  Animal  classes  now  and  in  the  future  would  have 
to  KNOW  about  the  protocol.  By  protocol,  we  mean 
the  exact  methods  that  we've  decided  all  pets  should 
have.  The  pet  contract  without  anything  to  back  it  up. 
But  what  if  one  of  the  programmers  gets  it  just  a tiny 
bit  wrong?  Like,  a method  takes  a String  when  it  was 
supposed  to  take  an  int?  Or  they  named  it  c/oFriendly() 
instead  of  beFriendlyO?  Since  it  isn't  in  a contract, 
the  compiler  has  no  way  to  check  you  to  see  if  you've 
implemented  the  methods  correctly.  Someone 
could  easily  come  along  to  use  the  pet  Animal 
classes  and  find  that  not  all  of  them  work 
quite  right. 


, -WrfU  ONLY 


And  second,  you  don't  get  to  use 
polymorphism  for  the  pet  methods. 
Every  class  that  needs  to  use 
pet  behaviors  would  have  to 
know  about  each  and  every 
class!  In  other  words, 
you  can't  use  Animal 
as  the  polymorphic 
type  now,  because  the 
compiler  won't  let  you  call 
a Pet  method  on  an  Animal 
reference  (even  if  it's  really  a 
Dog  object)  because  class  Animal 
doesn't  have  the  method. 
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So  what  we  REALLY  need  is: 

♦ A way  to  have  pet  behavior  in  just  the  pet  classes 

♦ A way  to  guarantee  that  all  pet  classes  have  all  of  the  same 
methods  defined  (same  name,  same  arguments,  same  return 
types,  no  missing  methods,  etc.),  without  having  to  cross  your 
fingers  and  hope  all  the  programmers  get  it  right. 

♦ A way  to  take  advantage  of  polymorphism  so  that  all  pets  can  have 
their  pet  methods  called,  without  having  to  use  arguments,  return 
types,  and  arrays  for  each  and  every  pet  class. 


It  looks  like  we  need  TWO 
superclasses  at  the  top 
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There's  just  one  problem  with  the  "two  superclasses"  approach... 

It’s  called  “multiple  inheritance” 
and  it  can  be  a Really  Bad  Thing. 

That  is,  if  it  were  possible  to  do  in  Java. 

But  it  isn't,  because  multiple  inheritance  has  a problem 
known  as  The  Deadly  Diamond  of  Death. 


Deadly  Diamond  of  Death 


A language  that  allows  the  Deadly  Diamond  of  Death  can  lead  to 
some  ugly  complexities,  because  you  have  to  have  special  rules  to 
deal  with  the  potential  ambiguities.  And  extra  rules  means  extra 
work  for  you  both  in  learning  those  rules  and  watching  out  for 
those  “special  cases”.  Java  is  supposed  to  be  simple , with  consistent 
rules  that  don’t  blow  up  under  some  scenarios.  So  Java  (unlike 
C++)  protects  you  from  having  to  think  about  the  Deadly  Dia- 
mond of  Death.  But  that  brings  us  back  to  the  original  problem! 
How  do  we  handle  the  Animal/Pet  thing ? 
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Interface  to  the  rescue! 

Java  gives  you  a solution.  An  interface.  Not  a GUI  interface,  not  the  generic 
use  of  the  word  interface  as  in,  “That’s  the  public  interface  for  the  Button 
class  API,”  but  the  Java  keyword  interface. 

A Java  interface  solves  your  multiple  inheritance  problem  by  giving  you 
much  of  the  polymorphic  benefits  of  multiple  inheritance  without  the  pain 
and  suffering  from  the  Deadly  Diamond  of  Death  (DDD). 

The  way  in  which  interfaces  side-step  the  DDD  is  surprisingly  simple:  make 
all  the  methods  abstract!  That  way,  the  subclass  must  implement  the  methods 
(remember,  abstract  methods  must  be  implemented  by  the  first  concrete 
subclass),  so  at  runtime  the  JVM  isn’t  confused  about  which  of  the  two 
inherited  versions  it’s  supposed  to  call. 


Pet 


abstract  void  beFriendlyf); 
abstract  void  playO; 


A Java  interface  is  like  a 
100%  pure  abstract  class. 


.w.  Walts-A 


To  DEFINE  an  interface: 


public  interface  Pet  { . . . } 


\ 
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To  IMPLEMENT  an  interface: 


public  class  Dog  extends  Canine  implements  Pet  { . 

\ 
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Making  and  Implementing 
the  Pet  interface 


o?  'class  Y*re 


\ 

public  interface  Pet  { 
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public  abstract  void  beFriendlyO 
public  abstract  void  play() ; 


no  lood'f! 


public  class  Dog  extends  Canine  implements  Pet  { 


Vow  sav 

l/'  {ollow/ed  w the  "3"* 
^ the  mtertate. 


public  void  beFriendlyO  { . . . } 
public  void  play()  { . . } ✓ 


public  void  roam()  { . . . } 
public  void  eat()  { . . . } 
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v;  Wait  a minute,  interfaces  don't 
really  give  you  multiple  inheritance, 
because  you  can't  put  any 
implementation  code  in  them.  If  all 
the  methods  are  abstract,  what  does 
an  interface  really  buy  you? 

Polymorphism,  polymorphism, 
polymorphism.  Interfaces  are  the 
ultimate  in  flexibility,  because  if  you 
use  interfaces  instead  of  concrete 
subclasses  (or  even  abstract  superclass 
types)  as  arguments  and  return 


types,  you  can  pass  anything  that 
implements  that  interface.  And  think 
about  it — with  an  interfaces  class 
doesn't  have  to  come  from  just  one 
inheritance  tree.  A class  can  extend 
one  class,  and  implement  an  interface. 
But  another  class  might  implement 
the  same  interface,  yet  come  from  a 
completely  different  inheritance  tree! 
So  you  get  to  treat  an  object  by  the 
role  it  plays,  rather  than  by  the  class 
type  from  which  it  was  instantiated. 

In  fact,  if  you  wrote  your  code  to  use 
interfaces,  you  wouldn't  even  have  to 
give  anyone  a superclass  that  they  had 


to  extend.  You  could  just  give  them 
the  interface  and  say,"Here,'l  don't 
care  what  kind  of  class  inheritance 
structure  you  come  from,  just 
implement  this  interface  and  you'll  be 
good  to  go." 

The  fact  that  you  can't  put  in 
implementation  code  turns  out  not  to 
be  a problem  for  most  good  designs, 
because  most  interface  methods 
wouldn't  make  sense  if  implemented 
in  a generic  way.  In  other  words,  most 
interface  methods  would  need  to 
be  overridden  even  if  the  methods 
weren't  forced  to  be  abstract. 
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Classes  from  different  inheritance  trees 
can  implement  the  same  interface. 
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When  you  use  a class  as  a polymorphic  type  (like  an 
array  of  type  Animal  or  a method  that  takes  a Canine 
argument),  the  objects  you  can  stick  in  that  type 
must  be  from  the  same  inheritance  tree.  But  not  just 
anywhere  in  the  inheritance  tree;  the  objects  must  be 
from  a class  that  is  a subclass  of  the  polymorphic  type. 
An  argument  of  type  Canine  can  accept  a Wolf  and  a 
Dog,  but  not  a Cat  or  a Hippo. 

But  when  you  use  an  interface  as  a polymorphic 
type  (like  an  array  of  Pets),  the  objects  can  be 
from  anywhere  in  the  inheritance  tree.  The  only 
requirement  is  that  the  objects  are  from  a class  that 
implements  the  interface.  Allowing  classes  in  different 
inheritance  trees  to  implement  a common  interface 
is  crucial  in  the  Java  API.  Do  you  want  an  object 
to  be  able  to  save  its  state  to  a hie?  Implement  the 
Serializable  interface.  Do  you  need  objects  to  run 


their  methods  in  a separate  thread  of  execution? 
Implement  Runnable.  You  get  the  idea.  You’ll 
learn  more  about  Serializable  and  Runnable  in  later 
chapters,  but  for  now,  remember  that  classes  from 
any  place  in  the  inheritance  tree  might  need  to 
implement  those  interfaces.  Nearly  any  class  might 
want  to  be  saveable  or  runnable. 

Better  still,  a class  can  implement 
multiple  interfaces! 

A Dog  object  IS-A  Canine,  and  IS-A  Animal,  and 
IS-A  Object,  all  through  inheritance.  But  a Dog  IS-A 
Pet  through  interface  implementation,  and  the  Dog 
might  implement  other  interfaces  as  well.  You  could 
say: 

public  class  Dog  extends  Animal  implements 
Pet,  Saveable,  Paintable  { ...  } 
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How  do  you  know  whether  to  make  a 
class,  a subclass,  an  abstract  class,  or 
an  interface? 

^ Make  a class  that  doesn't  extend  anything 

(other  than  Object)  when  your  new  class  doesn't 
pass  the  I S-A  test  for  any  other  type. 

^ Make  a subclass  (in  other  words,  extend  a class) 
only  when  you  need  to  make  a more  specific 
version  of  a class  and  need  to  override  or  add 
new  behaviors. 

^ Use  an  abstract  class  when  you  want  to  define 
a template  for  a group  of  subclasses,  and  you 
have  at  least  some  implementation  code  that  all 
subclasses  could  use.  Make  the  class  abstract 
when  you  want  to  guarantee  that  nobody  can 
make  objects  of  that  type. 

^ Use  an  interface  when  you  want  to  define  a role 
that  other  classes  can  play,  regardless  of  where 
those  classes  are  in  the  inheritance  tree. 
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Invoking  the  superclass 
version  of  a method 

% What  if  you  make  a concrete  subclass 
and  you  need  to  override  a method,  but  you 
want  the  behavior  in  the  superclass  version  of 
the  method?  In  other  words,  what  if  you  don't 
need  to  replace  the  method  with  an  override, 
but  you  just  want  to  add  to  it  with  some 
additional  specific  code. 

Ahhh...  think  about  the  meaning  of  the 
word  'extends'  One  area  of  good  00  design  looks 
at  how  to  design  concrete  code  that's  meant  to 
be  overridden.  In  other  words, you  write  method 
code  in,  say,  an  abstract  class,  that  does  work 
that's  generic  enough  to  support  typical  concrete 
implementations.  But,  the  concrete  code  isn't 
enough  to  handle  all  of  the  subclass-specific 
work.  So  the  subclass  overrides  the  method 
and  extends  it  by  adding  the  rest  of  the  code. 

The  keyword  super  lets  you  invoke  a superclass 
version  of  an  overridden  method,  from  within  the 
subclass. 

It  method  dode  inside  a 
BuzzwordReport  subdlass  says: 

super . runReport ( ) 

the  runReportO  method  inside 
the  superdlass  Report  will  run 


abstract  class  Report  { jr  that SVA 
void  runReport ( ) { ^ 

//  set-up  report 

} 

void  printReport ( ) { 

//  generic  printing 

} 

} 

class  BuzzwordsReport  extends  Report  { 


void  runReport ( ) { 


super . runReport ( ) ; 
buzzwordCompliance () ; 
printReport ( ) ; 


c ver s*on» 

fro  somC 
syedVr 


svA>d\a^- 
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} 

void  buzzwordCompliance ()  { . . . } 


A)t\asS 


super.runReport(); 

A reterende  to  the  subdlass  objedt 
(Buz^wordReport)  will  always  da  1 1 
the  subdlass  version  ot  an  overridden 
method-  That's  polymorphism. 

But  the  subdlass  dode  dan  dal  I 
super  runReportO  to  invoke  the 
superdlass  version. 


0 


sw^evtlass  «.eiV»o<is 

tKc  **ridde» 

run  RcportO 


The  super  keyword  is  really  a reterende 
to  the  superdlass  portion  ok  an  objedt- 
l/Vhen  subdlass  dode  uses  super,  as  in 
super  runReportO,  the  superdlass  version  ol 
the  method  will  run. 
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BULLET  POINTS  

y When  you  don’t  want  a class  to  be  instantiated  (in  other  words,  you  don’t 
want  anyone  to  make  a new  object  of  that  class  type)  mark  the  class  with  the 
abstract  keyword. 

y An  abstract  class  can  have  both  abstract  and  non-abstract  methods. 

y If  a class  has  even  one  abstract  method,  the  class  must  be  marked  abstract. 

y An  abstract  method  has  no  body,  and  the  declaration  ends  with  a semicolon  (no 
curly  braces). 

y All  abstract  methods  must  be  implemented  in  the  first  concrete  subclass  in  the 
inheritance  tree. 

y Every  class  in  Java  is  either  a direct  or  indirect  subclass  of  class  Object  (java.lang. 
Object). 

y Methods  can  be  declared  with  Object  arguments  and/or  return  types. 

y You  can  call  methods  on  an  object  only  if  the  methods  are  in  the  class  (or  interface) 
used  as  the  reference  variable  type,  regardless  of  the  actual  object  type.  So,  a 
reference  variable  of  type  Object  can  be  used  only  to  call  methods  defined  in  class 
Object,  regardless  of  the  type  of  the  object  to  which  the  reference  refers. 

y A reference  variable  of  type  Object  can’t  be  assigned  to  any  other  reference  type 
without  a cast.  A cast  can  be  used  to  assign  a reference  variable  of  one  type  to  a 
reference  variable  of  a subtype,  but  at  runtime  the  cast  will  fail  if  the  object  on  the 
heap  is  NOT  of  a type  compatible  with  the  cast. 

Example:  Dog  d = (Dog)  x.getObject (aDog)  ; 

y All  objects  come  out  of  an  ArrayList<Object>  as  type  Object  (meaning,  they  can  be 
referenced  only  by  an  Object  reference  variable,  unless  you  use  a cast). 

y Multiple  inheritance  is  not  allowed  in  Java,  because  of  the  problems  associated  with 
the  “Deadly  Diamond  of  Death”.  That  means  you  can  extend  only  one  class  (i.e.  you 
can  have  only  one  immediate  superclass). 

y An  interface  is  like  a 1 00%  pure  abstract  class.  It  defines  only  abstract  methods. 

y Create  an  interface  using  the  interface  keyword  instead  of  the  word  class. 

y Implement  an  interface  using  the  keyword  implements 
Example:  Dog  implements  Pet 

y Your  class  can  implement  multiple  interfaces. 

y A class  that  implements  an  interface  must  implement  all  the  methods  of  the 
interface,  since  all  interface  methods  are  implicitly  public  and  abstract. 

y To  invoke  the  superclass  version  of  a method  from  a subclass  that’s  overridden  the 
method,  use  the  super  keyword.  Example:  super  .runReport()  ; 


V'/ There's  still  something 
strange  here...  you  never 
explained  how  it  is  that 
ArrayList<Dog>  gives  back  Dog 
references  that  don't  need  to  be 
cast,  yet  the  ArrayList  class  uses 
Object  in  its  methods,  not  Dog 
(or  DotCom  or  anything  else). 
What's  the  special  trick  going  on 
when  you  say  ArrayList<Dog>? 

You're  right  for  calling  it  a 
special  trick.  In  fact  it  is  a special 
trick  that  ArrayList<Dog>  gives 
back  Dogs  without  you  having 
to  do  any  cast,  since  it  looks  like 
ArrayList  methods  don't  know 
anything  about  Dogs,  or  any  type 
besides  Object. 

The  short  answer  is  that  the 
compiler  puts  in  the  cast  for  you! 
When  you  say  ArrayList<Dog>, 
there  is  no  special  class  that  has 
methods  to  take  and  return  Dog 
objects,  but  instead  the  <Dog> 
is  a signal  to  the  compiler  that 
you  want  the  compiler  to  let 
you  put  ONLY  Dog  objects  in 
and  to  stop  you  if  you  try  to  add 
any  other  type  to  the  list.  And 
since  the  compiler  stops  you 
from  adding  anything  but  Dogs 
to  the  ArrayList,  the  compiler 
also  knows  that  its  safe  to  cast 
anything  that  comes  out  of  that 
ArrayList  do  a Dog  reference.  In 
other  words,  using  ArrayList<Dog> 
saves  you  from  having  to  cast 
the  Dog  you  get  back.  But  it's 
much  more  important  than  that... 
because  remember,  a cast  can 
fail  at  runtime,  and  wouldn't  you 
rather  have  your  errors  happen 
at  compile  time  rather  than,  say, 
when  your  customer  is  using  it  for 
something  critical? 

But  there's  a lot  more  to  this  story, 
and  we'll  get  into  all  the  details  in 
the  Collections  chapter. 
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exercise:  What’s  the  Picture? 


gRcise 


(riven: 


Here's  your  chance  to  demonstrate  your  artistic  abilities.  On  the  left  you'll 
find  sets  of  class  and  interface  declarations.  Your  job  is  to  draw  the  associated 
class  diagrams  on  the  right.  We  did  the  first  one  for  you.  Use  a dashed  line  for 
"implements"and  a solid  linefor"extends" 

Whatfc  the  Picture  ? 


1) 


public  interface  Foo  { } 

public  class  Bar  implements  Foo  { } 


2) 


public  interface  Vinn  { } 

public  abstract  class  Vout  implements  Vinn 


2) 


1) 


(imtcv-Padc) 

Foo 


\ 

public  abstract  class  Mu f fie  implements  Whuffie  { } 

public  class  Fluffie  extends  Muffie  { } 

public  interface  Whuffie  { } 


4) 


public  class  Zoop  { } 

public  class  Boop  extends  Zoop  { } 

public  class  Goop  extends  Boop  { } 


4) 


5) 


public  class  Gamma  extends  Delta  implements  Epsilon  { } 

public  interface  Epsilon  { } 

public  interface  Beta  { } 

public  class  Alpha  extends  Gamma  implements  Beta  { } 

public  class  Delta  { } 


5) 
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RctSe 


(riven: 


Click 

/ 

S. 

Clack 

Fee 

Fi 

— 

On  the  left  you'll  find  sets  of  class  diagrams.  Your  job  is  to  turn 
these  into  valid  Java  declarations.  We  did  number  1 for  you 
(and  it  was  a tough  one). 

Whatfc  the  Peclaration  ? 

1)  publid  dlass  Ciidk  { } 

publid  dlass  Cladk  extends  Ciidk  { } 


2) 


3) 


4) 


Bar 

Baz 

T 


KEY 


extends 
! implements 

I Clack  ~^1  class 


| ciack  interface 

| ciack  | abstract  class 
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puzzle:  Pool  Puzzle 


P«®1 

Puzz]e  Y— j 


Your  job  is  to  take  code  snippets  from  the  pool  and 
place  them  into  the  blank  lines  in  the  code  and  out- 
put. You  may  use  the  same  snippet  more  than  once, 
and  you  won't  need  to  use  all  the  snippets.  Your 
goal  is  to  make  a set  of  classes  that  will  compile 
and  run  and  produce  the  output  listed. 


Nose 


abstract  class  Picasso  implements 


return  7; 


class 


class 


{ } 
{ 


return  5; 


Note:  Each  snippet 
from  the  pool  can  be 
used  more  than  once! 


public 


extends  Clowns  { 


public  static  void  main (String  []  args)  { 


i [ 0 ] = new 

i [ 1 ] = new 

i [ 2 ] = new 


for(int  x = 0;  x < 3;  x++)  { 

System . out . print in ( 

+ " " + .getClass(  ) 

} 


| File  Edit  Window  Help  BeAfraid 

n 

% java 

5 class 

Acts 

7 class 

Clowns 

Of  7 6 
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Exercise  Solutions 


Whatfc  the  Picture  ? 


5) 


Delta 


(in-tev-Pade) 

Bf>silon 


(~)3n\rr\3 


Cm-tev-Pade) 

Bela 


'V-47 


Alfha 


Whatfc  the  Peclaratiow  ? 


2) 

3) 

4) 


publid  abstvadt  dl ass  Top  { } 
publid  dlass  Tip  extends  Top  { } 

publid  abstvadt  dlass  Fee  { } 

publid  abstvadt  dlass  Fi  extends  Fee  { } 

publid  inter-Pade  Foo  { } 

publid  dlass  Bav-  implements  Foo  { } 

publid  dlass  Baz.  extends  Bav-  { } 


publid  intevtade  7-^ta  { } 

publid  dlass  Alpha  implements  7-eta  { } 

publid  intev-t ade  Beta  { } 

publid  dlass  Delta  extends  Alpha  implements  Beta  { } 
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interface  Nose  { 

public  int  iMethod(  ) ; 

} 

abstract  class  Picasso  implements  Nose  { 

public  int  iMethod(  ) { 

return  7; 

} 

} 

class  Clowns  extends  Picasso  { } 

class  Acts  extends  Picasso  { 
public  int  iMethod(  ) { 

return  5;  } 


public  class  Of76  extends  Clowns  { 

public  static  void  main (String  []  args)  { 

Nose  [ ] i = new  Nose  [3] ; 

i [ 0 ] = new  Acts( ) ; 

i [ 1 ] = new  Clowns( ) ; 

i [ 2 ] = new  Of76( ) ; 

for  (int  x = 0;  x < 3;  x++)  { 

System . out . print in ( i [x]  . iMethod(  ) 


Output 


%java  Of 7 6 
5 class  Acts 
7 class  Clowns 
7 class  Of 7 6 
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Life  and  Death 
of  an  Object 


Objects  are  born  and  objects  die.  You're  in  charge  of  an  object's  lifecycle. 

You  decide  when  and  howto  construct  it, You  decide  when  to  destroy  it. Except  you  don't 
actually  destroy  the  object  yourself,  you  simply  abandon  it.  But  once  it's  abandoned,  the 
heartless  Garbage  Collector  (gc)  can  vaporize  it,  reclaiming  the  memory  that  object  was 
using.  If  you're  gonna  write  Java,  you're  gonna  create  objects.  Sooner  or  later,  you're  gonna 
have  to  let  some  of  them  go,or  risk  running  out  of  RAM.  In  this  chapter  we  look  at  how  objects 
are  created,  where  they  live  while  they're  alive,  and  howto  keep  or  abandon  them  efficiently. 
That  means  we'll  talk  about  the  heap,  the  stack,  scope,  constructors,  super  constructors,  null 
references, and  more. Warning:this  chapter  contains  material  about  object  death  that  some 
may  find  disturbing.  Best  not  to  get  too  attached. 
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the  stack  and  the  heap 


The  Stack  and  the  Heap:  where  things  live 


Before  we  can  understand  what  really  happens  when 
you  create  an  object,  we  have  to  step  back  a bit  We 
need  to  learn  more  about  where  everything  lives 
(and  for  how  long)  in  Java,  That  means  we  need  to 
learn  more  about  the  Stack  and  die  Heap.  In  Java,  we 
(programmers)  care  about  two  areas  of  memory — the 
one  where  objects  live  (the  heap),  and  the  one 
where  method  invocations  and  local  variables  live 
(the  stack).  When  a JVM  starts  up,  it  gets  a chunk  of 
memory  from  the  underlying  OS,  and  uses  it  to  run 
your  Java  program.  How  much  memory,  and  whether 
or  not  you  can  tweak  it,  is  dependent  on  which 
version  of  the  JVM  (and  on  which  platform)  you're 


running.  But  usually  you  wm\  7 have  anything  to  say 
about  it  And  with  good  programming,  you  probably 
won't  care  (more  on  that  a little  later). 

We  know  that  all  objects  live  on  the  garbage-collectible 
heap,  but  we  haven't  yet  looked  at  where  variables 
live.  And  where  a variable  lives  depends  on  what  kind 
of  variable  it  is.  And  by  “kind*1,  we  don't  mean  type 
(i.e.  primitive  or  object  reference).  The  two  kinds  ot 
variables  whose  lives  we  care  about  now  are  instance 
variables  and  local  variables.  Local  variables  are  also 
known  as  stack  variables,  which  is  a big  clue  for  where 
they  live. 


The  Stack 


Where  method  invocations 
and  local  variables  five 


The  Heap 

Where  ALL  objects  live 


,\s0  Vw*"" 


Instance  Variables 


Local  Variables 


Instance  variables  are  declared  Inside  a class  but  not 
Inside  a method.They  represent  the  "fields"  that  each 
Individual  object  has  (which  can  be  filled  with  different 
values  for  each  Instance  of  the  class).  Instance  variables 
live  inside  the  object  they  belong  to. 


public  class  Duck  { 

int  size;,,  ^ putV  a 


“si** 


\&>\  t 


\tSK. 


Local  variables  are  declared  inside  a method,  Including 
method  parameters* They're  temporary.and  live  only  as 
long  as  the  method  is  on  the  stack  (in  other  words.as  long  as 
the  method  has  not  reached  the  dosing  curly  brace). 


public  void  foo 
int  i = x + 
boolean  b - 

} 


it  X)  { 

- 


dxt 
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Methods  are  stacked 

When  you  call  a method,  the  method  lands  on 
the  top  of  a cal]  stack.  That  new  thing  that's 
actually  pushed  onto  the  stack  is  the  stack 
frame,  and  it  holds  the  state  of  the  method 
including  which  line  of  code  is  executing,  and 
the  values  of  all  local  variables. 

The  method  at  the  top  of  the  stack  is  always 
the  currendy-running  method  for  diat  stack 
(for  now,  assume  there's  only  one  stack,but  in 
chapter  14  we'll  add  more.)  A method  stays  on 
the  stack  until  the  method  hits  its  closing  curly 
brace  (which  means  the  method's  done).  If 
method  foo()  calls  method  bar(),  method  bar()  is 
stacked  on  top  of  method  foo(). 


A call  stack  with  two  methods 


S 

eiion  of 


©t  statk 


\ot^l  variables 
parameter  *) 


The  method  on  the  top  of  the 
stack  is  always  the  currently- 
executing  method. 


public  void  doStuff()  { 
boolean  b = true; 
go<4); 

1 

public  void  go(int  x)  { 
int  z = x + 24 ; 
crazy ( ) ; 

//  imagine  more  code  here 

) 

public  void  crazy ()  { 
char  c - 'a' ; 

) 


A stack  scenario 

The  code  on  the  left  is  a snippet  (we  don't  care  what  the  rest  of  die 
class  looks  like)  widi  three  methods.  The  first  method  (doStuffO)  calls 
the  second  method  (go())y  and  the  second  mediod  calls  the  third 
(crazy())~  Each  method  declares  one  local  variable  within  the  body 
of  the  method,  and  method  go()  also  declares  a parameter  variable 
(which  means  go()  has  two  local  variables). 


Code  from  another 
class  calls  doStuffO, 
and  doStuffO  goes 
into  a stack  frame 
at  the  top  of  the 
stack.The  boolean 
variable  named  V 
goes  on  the  doStuffO 
stack  frame. 


doStuffO  calls  goO, 
goQ  is  pushed  on 
top  of  the  stack. 
Variables  Y and  Y 
are  in  the  goO  stack 
frame. 


^ goQ  calls  crazyO, 
crazyO  is  now  on  the 
top  of  the  stack, 
with  variable  'c'  in 
the  frame. 


is 

popped  off  the  stack. 
Execution  goes  back 
to  the  goO  method, 
and  picks  up  at  the 
line  following  the  call 

to  crazyO. 


crazyO  completes, 
and  its  stack  frame 
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What  about  local  variables  that  are  objects? 


Remember,  a non-primitive  variable  holds  a reference  to  an 
object,  not  the  object  itself.  You  already  know  where  objects 
live — on  the  heap.  It  doesn’t  matter  where  they’re  declared  or 
created.  If  the  local  variable  is  a reference  to  an  object,  only 
the  variable  ( the  reference/remote  control)  goes  on  the  stack . 

The  object  itself  still  goes  in  the  heap . 


awA 


public  class  StackRaf  { 
public  void  foof()  ( 
barf  ()  ; 

} 

public  void  barf()  { 

Duck  d = new  Duck (24) ; 

) 


w»m  a,  ^ 


C^SIst^esdtTO 

% One  more  time,  WHY  are  we  learning  the 
whole  stack/ heap  thing?  How  does  this  help  me? 
Do  I really  need  to  learn  about  It? 

</\^  Knowing  the  fundamentals  of  the  Java 
Stack  and  Heap  Is  crucial  If  you  want  to  understand 
variable  scope,  object  creation  Issues,  memory 
management,  threads, and  exception  handling. 

We  cover  threads  and  exception  handling  In  later 
chapters  but  the  others  you'll  learn  In  this  one.  You 
do  not  need  to  know  anything  about  how  the  Stack 
and  Heap  are  Implemented  in  any  particular  JVM 
and/or  platform.  Everything  you  need  to  know 
about  the  Stack  and  Heap  Is  on  this  page  and  the 
previous  one.  If  you  nail  these  pages,  all  the  other 
topics  that  depend  on  your  knowing  this  stuff  will 
go  much,  much,  much  easier.  Once  again,  some  day 
you  will  SO  thank  us  for  shoving  Stacks  and  Heaps 
down  your  throat. 


y Java  has  two  areas  of  memory  we  care  about 
the  Stack  and  the  Heap. 

y Instance  variables  are  variables  declared 
inside  a class  but  outside  any  method. 

y Local  variables  are  variables  declared  inside  a 
method  or  method  parameter. 

y All  local  variables  live  on  the  stack,  in  the 
frame  corresponding  to  the  method  where  the 
variables  are  declared. 

y Object  reference  variables  work  just  like  primi- 
tive variables— if  the  reference  is  declared  as  a 
local  variable,  it  goes  on  the  stack. 

y All  objects  live  In  the  heap,  regardless  of 
whether  the  reference  is  a local  or  instance 
variable. 
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If  local  variables  live  oh  the  stack 
where  do  instance  variables  live? 

m **  ■ — 

When  you  say  new  CellPhone  (),  Java  has  to  make 
space  on  the  Heap  for  that  CellPhone.  But  how  much 
space?  Enough  for  the  object,  which  means  enough  to 
house  all  of  the  object's  instance  variables.  That's  right, 
instance  variables  live  on  the  Heap,  inside  the  object 
they  belong  to. 

Remember  that  the  values  of  an  object's  instance 
variables  live  inside  the  object.  If  the  instance  variables 
are  all  primitives,  Java  makes  space  for  the  instance 
variables  based  on  the  primitive  type.  An  int  needs 
32  bits,  a long  64  bits,  etc.  Java  doesn't  care  about  the 
value  inside  primitive  variables;  the  bit-size  of  an  int 
variable  is  the  same  (32  bits)  whether  the  value  of  the 
int  is  32,000,000  or  32. 

But  what  if  the  instance  variables  are  objects ? What  if 
CellPhone  HAS-A  Antenna?  In  other  words,  CeUPbone 
has  a reference  variable  of  type  Antenna. 

When  the  new  object  has  instance  variables  that  are 
object  references  rather  than  primitives,  the  real 
question  is:  does  the  object  need  space  for  all  of 
the  objects  it  holds  references  to?  The  answer  is,  not 
exactly . No  matter  what,  Java  has  to  make  space  for  the 
instance  variable  values . But  remember  that  a reference 
variable  value  is  not  the  whole  object , but  merely  a remote 
control  to  the  object.  So  if  CellPhone  has  an  instance 
variable  declared  as  the  non-primitive  type  Antenna, 
Java  makes  space  within  die  CellPhone  object  only  for 
the  Antenna's  remote  control  (i.e.  reference  variable)  but 
not  the  Antenna  object 

Well  then  when  does  the  Antenna  object  get  space  on 
the  Heap?  First  we  have  to  find  out  when  the  Antenna 
object  itself  is  created.  That  depends  on  the  instance 
variable  declaration.  If  the  instance  variable  is  declared 
but  no  object  is  assigned  to  it,  then  only  the  space  for 
the  reference  variable  (the  remote  control)  is  created. 

private  Antenna  ant; 

No  actual  Antenna  object  is  made  on  the  heap  unless 
or  until  the  reference  variable  is  assigned  a new 
Antenna  object. 

private  Antenna  ant  = new  Antenna () ; 


CellPhone  object 


Object  with  two  primitive  instance  variables- 
Space  i&r  the  variables  lives  in  the  object 


CellPhone  object 


Object  with  one  non-primitive  instance  variable— 
a reference  to  a*  A ntenna  object,  but  no  actual 
Antenna  object  This  is  what  you  jet  i-f  you 
declare  the  variable  tat  dor/t  initialise  it  with 
a n actual  Antenna  object 

public  class  CellPhone  { 
private  Antenna  ant; 

) 


Object  with  one  non- primitive  instance  variable, 
and  the  Antenna  variable  is  assigned  a new 
Antenna  object 


public  class  CellPhone  { 

private  Antenna  ant  = new  Antenna  ()  ; 

} 
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The  miracle  of  object  creation 

Now  that  you  know  where  variables  and  objects  live,  we  can  dive  into 
the  mysterious  world  of  object  creation.  Remember  the  three  steps 
of  object  declaration  and  assignment:  declare  a reference  variable, 
create  an  object,  and  assign  the  object  to  the  reference. 

But  until  now,  step  two — where  a miracle  occurs  and  the  new  object 
is  “bom" — has  remained  a Big  Mystery.  Prepare  to  learn  the  facts  of 
object  life.  Hopeyou*re  not  squeamish. 


Review  the  3 steps  of  object 
declaration,  creation  and  assignment: 


O Declare  a reference 
variable 

ftA aVc  * f \ass  0*  Duck  myDuck  = new  Duck  ( ) ; 


^ Create  an  object 

. ^ Duck  myDuck  = new  DuckQ  ; 

Duck  objec+ 


t * 


Yt 


I Link  the  object  and 
the  reference 

Duck  myDuck^) new  Duck()  ; 


buck  object 


buck  reference 
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Are  we  calling  a method  named  Duck()? 

Because  it  sure  looks  like  it. 


Duck  myDuck  = 


No. 


We’re  calling  the  Duck  constructor . 


A constructor  does  look  and  feel  a lot  Jike  a method,  but  it’s  not 
a method.  It's  got  the  code  that  runs  when  you  say  new.  In  other 
words,  the  code  that  runs  when  you  instantiate  an  object 

The  only  way  to  invoke  a constructor  is  with  the  keyword  now 
Followed  by  the  class  name.  The  JVM  finds  that  class  and  invokes 
the  constructor  In  that  class.  (OK,  technically  tins  isn't  the  only 
way  to  invoke  a constructor.  But  it's  the  only  way  to  do  it  from 
outside  a constructor.  You  can  call  a constructor  from  within 
another  constructor,  with  restrictions,  but  we’ll  get  into  all  that 
later  in  the  chapter.) 

But  where  is  the  constructor? 

If  we  didn’t  write  It,  who  did? 


a constructor  butts 

code  tbit  nmt  when  yon 
instantiate  as  object.  In 
other  words,  the  eode  that 
rani  whan  yo«  mqt  new  os 
a class  type. 

Every  olasi  yon  create  hu 
a constructor,  even  if  yon 
don't  write  it  jonrselL 


You  can  write  a constructor  for  your  class  (we’re  about  to  do 
that),  but  if  you  don’t,  the  compiler  writes  one  for  you! 

Here’s  what  the  compiler’s  default  constructor  looks  like: 


public  Duck ( ) ( 


} 


Notice  something  missing?  How  is  this 

different  from  a method?  15 

^ t\ass  rf"* 

j / public  Duck ()  ( 

//  constructor  coda  goes  bare 

•**•**'  ’ 


\jr\t 

AaW 
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Construct  a Puck 

The  key  feature  of  a constructor  is  that  it  runs 
before  the  object  can  be  assigned  to  a reference. 
That  means  you  get  a chance  to  step  in  and 
do  things  to  get  the  object  ready  for  use.  In 
other  words,  before  anyone  can  use  the  remote 
control  for  an  object,  the  object  has  a chance  to 
help  construct  itself.  In  our  Duck  constructor, 
we're  not  doing  anything  useful,  but  it  still 
demonstrates  the  sequence  of  events. 


public  class  Duck  { 


1 


public  Duck ()  { 

System,  out .println ("Quack") ; 


todC- 


The  constructor  gives 
you  a chance  to  step  into 
the  middle  of  new. 


public  class  UseADuck  { 


public  static  void  main  (String []  args) 
Duck  d = new  Duck ( ) ; 

> F' Th,s 


| Flip  Edit  Window  Help  Quack  | 


% java  UseADuck 
Quack 


A constructor  lets  you  Jump  Into  the  middle 
of  the  object  creation  step — into  the  middle 
of  new.  Can  you  imagine  conditions  where 
that  would  be  useful?  Which  of  these  might 
be  useful  In  a Car  class  constructor,  if  the  Car 
is  part  of  a Racing  Game?  Checkoff  the  ones 
that  you  came  up  with  a scenario  for. 


□ Increment  a counter  to  track  how  many  objects  of  this  class  type 
have  been  made. 

□ Assign  runtime-specific  state  (data  about  whal's  happening  NOW). 

□ Assign  values  to  the  object's  important  instance  variables. 

□ Get  and  save  a reference  to  the  object  that's  creating  (he  new  object. 

□ Add  the  object  to  an  ArrayUst. 

□ Create  HAS-A  objects. 

□ (your  idea  here) 
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Initializing  the  state  of  a new  Hock 

Most  people  use  constructors  to  initialize  the  state  of  an  object. 
In  other  words,  to  make  and  assign  values  to  the  object’s 
instance  variables. 

public  Duck()  { 
size  = 34; 

} 

That’s  all  well  and  good  when  the  Duck  class  developerknows 
how  big  the  Duck  object  should  be.  But  what  if  we  want  the 
programmer  who  is  using  Duck  to  decide  how  big  a particular 
Duck  should  be? 

Imagine  the  Duck  has  a size  instance  variable,  and  you  want  the 
programmer  using  your  Duck  class  to  set  the  size  of  the  new 
Duck.  How  could  you  do  it? 

Well,  you  could  add  a setSize()  setter  method  to  the  class.  But 
that  leaves  the  Duck  temporarily  without  a size*,  and  forces  the 
Duck  user  to  write  two  statements — one  to  create  the  Duck,  and 
one  to  call  the  setSize()  method.  The  code  below  uses  a setter 
method  to  set  the  initial  size  of  the  new  Duck. 

public  class  Duck  { 

int  size;  ^ ',*fVaWe 

public  Duck ( ) { 

System. out.println ("Quack")  ; ^ 

> ^ 

public  void  setSize(int  newSize)  { .« 

size  * newSize;  sc 

} 

} 


public  class  UseADuck  { 


public  static  void  main 
Duck  d = new  Duck ( ) ; 


d.setSize (42) 


(String []  args) { 


£«“  ikc 


‘Instance  variables  do  have  a default  value.  0 or 
0.0  for  numeric  primitives,  false  for  booleans,  and 
null  for  references. 


Why  do  you  need  to  write 
a constructor  if  the  compiler 
writes  one  for  you? 

A-  |fy°u  neec*  code  to  he*p 

initialize  your  object  and  get 
it  ready  for  use,  you'll  have  to 
write  your  own  constructor.  You 
might,  for  example,  be  depen- 
dent on  input  from  the  user 
before  you  can  finish  making 
the  object  ready.There's  another 
reason  you  might  have  to  write 
a constructor,  even  if  you  don't 
need  any  constructor  code 
yourself.  It  has  to  do  with  your 
superclass  constructor,  and  we'll 
talk  about  that  in  a few  minutes. 


How  can  you  tell  a con- 
structor from  a method?  Can 
you  also  have  a method  that's 
the  same  name  as  the  class? 

A-  Java  *ets  y°u  declare  a 
method  with  the  same  name  as 
your  class.  That  doesn't  make  it 
a constructor,  though.The  thing 
that  separates  a method  from  a 
constructor  is  the  return  type. 
Methods  must  have  a return 
type,  but  constructors  cannot 
have  a return  type. 


Are  constructors  inher- 
ited? If  you  don't  provide  a 
constructor  but  your  superclass 
does,  do  you  get  the  superclass 
constructor  instead  of  the 
default? 


A:  Nope.  Constructors  are 
not  inherited.  We'll  look  at  that  in 
just  a few  pages. 
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initializing  object  state 


Using  the  constructor  to  initialize 
important  Puck  state* 

If  an  object  shouldn't  be  used  until  one  or 
more  parts  of  its  state  (instance  variables)  have 
been  initialized,  don’t  let  anyone  get  ahold  of 
a Duck  object  until  you're  finished  initializing! 

It's  usually  way  too  risky  to  let  someone  make — 
and  get  a reference  to — a new  Duck  object  that 
isn't  quite  ready  for  use  until  that  someone  turns 
around  and  calls  the  setSizef)  method.  How  will 
the  Duck-user  even  knmv  that  he’s  required  to  call 
the  setter  method  after  making  the  new  Duck? 

The  best  place  to  put  initialization  code  is  in  the 
constructor.  And  all  you  need  to  do  is  make  a 
constructor  with  arguments. 

public  clans  Duck.  { 
int  size; 


public  Duck (int  duckSize)  ( 
System*  out* println ("Quack") 

size  = duckSize; 


.Wie  tVie  va'u<  ^ ^ 


System. out .println ("size  is  " + size); 

) 

> 


public  class  UseADuck  { 


V A 


public  static  void  main  (String[]  args)  { 
k Duck  d = new  Duck  (42 ) ; 


1 


> 

k. 


I File  Edit  Window  Help  Honk 


% java  UseADuck 


Quack 


■>  Wfc.  U ihe 


size  is  42 


‘Not  to  imply  that  not  all  Duck  state  Is  not  unimportant. 
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Make  it  easy  to  make  a Puck 

9e  sure  you  have  a ho-arg  constructor 


What  happens  if  the  Duck  constructor  takes  an  argument? 

Think  about  it.  On  the  previous  page,  there's  only  on^Duck 
constructor — and  it  takes  an  int  argument  for  the  size  of  the 
Duck.  That  might  not  be  a big  problem,  but  it  does  make  it 
harder  for  a programmer  to  create  a new  Duck  object,  especially 
if  the  programmer  doesn't  know  what  the  size  of  a Duck  should 
be.  Wouldn't  it  be  helpful  to  have  a default  size  for  a Duck,  so 
that  if  the  user  doesn't  know  an  appropriate  size,  he  can  still 
make  a Duck  that  works? 


Imagine  that  you  want  Duck  users  to  have  TWO  options 
for  making  a Duck — one  where  they  supply  the  Duck 
size  (as  the  constructor  argument)  and  one  where  they 
don't  specify  a size  and  thus  get  your  default  Duck  size . 


You  can't  do  this  cleanly  with  just  a single  constructor. 
Remember,  if  a method  (or  constructor — same  rules)  has 
a parameter,  you  must  pass  an  appropriate  argument  when 
you  invoke  that  method  or  constructor.  You  can’t  just  say,  “If 
someone  doesn't  pass  anything  to  the  constructor,  then  use 
the  default  size”,  because  they  won't  even  be  able  to  compile 
without  sending  an  int  argument  to  the  constructor  call.  You 
could  do  something  clunkly  like  this: 


public  class  Duck  { 
int  size; 


public  Duck(int  newSize) 


< x/rch^,'e.  , 

if  (nawSize  = 0)  ( 

llj  <ViX  ' 


size  = 27; 

} else  { 

size  = nawSize; 

1 


4oV^0T" 


But  that  means  the  programmer  making  a new  Duck  object  has 
to  know  that  passing  a w0”  is  the  protocol  for  getting  the  default 
Duck  size.  Pretty  ugly.  What  if  the  other  programmer  doesn't 
know  that?  Or  what  if  he  really  does  want  a zercnsize  Duck? 
(Assuming  a zero-sized  Duck  is  allowed.  If  you  don’t  want 
zero-sized  Duck  objects,  put  validation  code  in  the  constructor 
to  prevent  it.)  The  point  is,  it  might  not  always  be  possible 
to  distinguish  between  a genuine  u\  want  zero  for  the  size” 
constructor  argument  and  a Tm  sending  zero  so  you’ll  give 
me  the  default  size,  whatever  that  is”  constructor  argument. 


You  really  want  TWO  ways  to 
make  a new  Duck: 

public  class  Duck2  { 

int  size; 

public  Duck2()  ( 

//  supply  default  size 
size  = 27; 

) 

public  Duck2 (int  duckSize)  ( 
//  use  duckSize  parameter 
size  = duckSize; 

1 

) 


To  make  a Duck  when  you  know  the  size: 
Duck2  d = new  Duck2(15) ; 

To  make  a Duck  when  you  do  not  know 
the  size: 

Duck2  d2  «=  new  Duek2  ()  ; 

So  this  two-optlons-to-make-a-Duck  idea 
needs  two  constructors.  One  that  takes 
an  Int  and  one  that  doesn 'tdfyou  have 
more  than  one  co/wfri/cfor  In  a class, 

it  means  you  have  overloaded 

constructors . 
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Poesn't  the  compiler  always 
make  a no-arg  constructor 
for  you?  w0 1 

You  might  think  that  if  you  write  only 
a constructor  with  arguments,  the 
compiler  will  see  that  you  don't  have  a 
no-arg  constructor,  and  stick  one  in  for 
you.  But  that's  not  how  it  works.  The 
compiler  gets  involved  with  constructor- 
making  only  if  you  don't  say  anything  at  all 
about  constructors. 

If  you  write  a constructor  that 
takes  arguments,  and  you  still 
want  a no-arg  constructor, 
you’ll  have  to  build  the  no-arg 
constructor  yourself  I 

As  soon  as  you  provide  a constructor, 

ANY  kind  of  constructor,  the  compiler 
backs  off  and  says,  “OK  Buddy,  looks  like 
you're  in  charge  of  constructors  now.n 

If  you  have  more  than  one 
constructor  In  a class,  the 
constructors  MUST  have 
different  argument  lists. 

The  argument  list  includes  the  order 
and  types  of  the  arguments.  As  long  as 
they’re  different,  you  can  have  more 
than  one  constructor.  You  can  do  this 
with  methods  as  well,  but  we'll  get  to  that 
in  another  chapter. 
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Overloaded  constructors  means  you  have 
more  than  one  constructor  in  your  class. 

To  compile,  each  constructor  must  have  a 
different  argument  llstl 


The  class  below  is  legal  because  all  four  constructors  have 
different  argument  lists.  If  you  had  two  constructors  that  took 
only  an  int,  for  example,  the  class  wouldn't  compile.  What  you 
name  the  parameter  variable  doesn't  count  It's  the  variable 
type  (int,  Dog,  etc,)  and  order  that  matters.  You  can  have  two 
constructors  that  have  identical  types,  as  long  as  the  order  is 
different  A constructor  that  takes  a String  followed  by  an  int,  is 
not  the  same  as  one  that  takes  an  int  followed  by  a String. 


, ^ ^ ^ 

public  class  Mushroom  { ^ ^ 

public  Mushroom  (int  size)  ( } 


when  7°“ 


public  Mushroom  ( ) { > 

public  Mushroom  (boolean  isMagic)  { } 


don't  know  an'ftWn} 


when  know  ^ 
hut  don't  know 


or  not 


hheie  t*o  ha^ 


public  Mushroom  (boolean  isMagic,  int  size)  { 


’f  cc^ttfrden,  (public  Mushroom  (int  size,  boolean  isMagic)  { * ^ 


s 

know 


deferent 

it’*  o* 


iat  a*  ’ 


BULLfT  POINTS 


y Instance  variables  live  within  the  object  they  belong  to,  on 
the  Heap. 

y If  the  Instance  variable  is  a reference  to  an  object,  both 
the  reference  and  the  object  it  refers  to  are  on  the  Heap. 

y A constructor  is  the  code  that  runs  when  you  say  new  on 
a class  type. 

y A constructor  must  have  the  same  name  as  the  class,  and 
must  nof  have  a return  type, 

y You  can  use  a constructor  to  Initialize  the  state  (i.e.  the 
instance  variables)  of  the  object  being  constructed. 

y If  you  don’t  put  a constructor  in  your  class,  the  compiler 
will  put  In  a default  constructor. 

y The  default  constructor  is  always  a no-arg  constructor. 

y If  you  put  a constructor— any  constructor— in  your  class, 
the  compiler  will  not  build  the  default  constructor. 


y If  you  want  a no-arg  constructor,  and  you've  already  put 
in  a constructor  with  arguments,  you'll  have  to  build  the 
no-arg  constructor  yourself. 

y Always  provide  a no-arg  constructor  sf  you  can,  to  make  It 
easy  for  programmers  to  make  a working  object.  Supply 
default  values. 

y Overloaded  constructors  means  you  have  more  than  one 
constructor  in  your  class. 

y Overloaded  constructors  must  have  different  argument 
lists. 

y You  cannot  have  two  constructors  with  the  same 

argument  lists.  An  argument  list  Includes  the  order  and/or 
type  of  arguments, 

y Instance  variables  are  assigned  a default  value,  even 
when  you  don’t  explicitly  assign  one.  The  default  values 
are  0/0.0/false  for  primitives,  and  null  for  references. 
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en  your  pencil 

Match  the  new  Duck()  call  with  the  constructor 
that  runs  when  that  Duck  is  instantiated.  We  did 
the  easy  one  to  get  you  started. 

public  class  TestDuck  { 

public  static  void  main (String []  args) { 

int  weight  = a ; 
float  density  = 2.3F; 

String  name  = "Donald"; 
long[]  feathers  = {1,2,3, 4,5,6); 
boolean  canFly  — true; 
int  airspeed  = 22; 

Duck  [ J d = new  Duck  [7) 

d[0]  = new  Duck () ; 

d[l]  = new  Duck (density,  weight); 

d[2]  = new  Duck (name,  feathers); 

d[3]  = new  Duck (canFly) ; 

d[4]  = new  Duck(3.3F,  airspeed); 

d[5]  = new  Duck (false); 

d[6]  - new  Duck (airspeed,  density); 


class  Duck  { 

int  pounds  = 6; 

float  floatability  = 2.  IF; 

String  name  - "Generic"; 

long [ ] feathers  = {1,2, 3, 4,5, 6, 7); 

boolean  canFly  = true; 

int  max Speed  = 25; 

public  Duck ( ) ( 

System. out .println ("type  1 ducJc")  ; 

} 

public  Duck  (boolean  fly)  { 
canFly  = fly; 

System. out. println ("type  2 duck") ; 

) 

public  Duck (String  n,  long[]  f)  ( 
name  = n; 
feathers  = f; 

System. out. println ("type  3 duck") ; 

} 

public  Duck  (int  w,  float  f)  { 
pounds  = w; 
floatability  = f; 

System,  out,  printing  type  4 duck"); 

) 

public  Duck  (float  density,  int  max)  { 
floatability  = density; 
max Speed  = max; 

System,  out  .println  ("type  5 duck"); 

) 


St  Earlier  you  said  that  it's  good  to  have  a no-argu- 
ment  constructor  so  that  If  people  call  the  no-arg  con- 
structor, we  can  supply  default  values  for  the  "missing” 
arguments.  But  aren't  there  times  when  It's  Impossible  to 
come  up  with  defaults?  Are  there  times  when  you  should 
not  have  a no-arg  constructor  In  your  class7 

You're  right. There  are  times  when  a no-arg  construc- 
tor doesn't  make  sense.  You'd  see  this  in  the  Java  API— some 
classes  don't  have  a no-arg  constructor.The  Color  class,  for 
example,  represents  a...  color.  Color  objects  are  used  to,  for 
example,  set  or  change  the  color  of  a screen  font  or  GUI 
button.  When  you  make  a Color  Instance,  that  Instance  Is 
of  a particular  color  (you  know,  Death-by-Chocolate  Brown, 
Blue-Screen-of-Death  Blue,  Scandalous  Red,  etc.).  If  you 
make  a Color  object  you  must  specify  the  color  In  some  way. 


(We're  using  three  Ints  for  RGB  values  here. We'll  get  into 
using  Color  later,  in  the  Swing  chapters.)  Otherwise,  what 
would  you  get?  The  Java  API  programmers  could  have  de- 
cided that  \f  you  call  a no-arg  Color  constructor  you'll  get  a 
lovely  shade  of  mauve.  But  good  taste  prevailed. 

If  you  try  to  make  a Color  without  supplying  an  argument: 

Color  c = now  Color <) ; 

The  compiler  freaks  out  because  It  can't  find  a matching  no 
arg  constructor  in  the  Color  class. 

| Re  Window  H&tp  StOpBeli^StupId  | 


cannot  resolve  symbol 
constructor  Color () 
location : class 
java . aw t. Color 
Color  c = new  Color () ; 


Color  c = new  Color (3,45, 200) ; 
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Nahoreview:  four  things  to 
remember  about  constructors 


£ A constructor  is  the  code  that  runs  when 
somebody  says  new  on  a doss  type 

Duck  d = new  Duck ( ) ; 


£ A constructor  must  have  the  same  name 
as  the  class,  and  no  return  type 


public  Duck(int  size)  { } 


If  you  don't  put  a constructor  in  your  class, 
the  compiler  puts  in  a default  constructor 
The  default  constructor  is  always  a no-arg 
constructor. 


public  Duck  ( ) [ } 


£ Vou  can  have  more  than  one  constructor  fn  your  class, 
as  long  as  the  argument  lists  are  different.  Having 
more  than  one  constructor  in  a class  means  you  have 
overloaded  constructors. 


public 

public 

public 

public 


Duck()  { } 

Duck(int  size)  { } 

Duck  (String  name)  { ) 

Duck (String  name,  int  size) 


Doing  all  the  Brain  Barbells  has  been  shown  to  produce  a 42%  increase  in 
neuron  size.  And  you  know  what  they  say,  *Sig  neurons..." 


What  about  superclasses? 


When  you  make  a Dog, 
should  the  Canine 
constructor  run  too? 

If  the  superclass  Is  abstract 
should  It  even  have  a 
constructor? 


We'll  look  at  this  on  the  next 
few  pages,  so  stop  now  and 
think  about  the  implications  of 
constructors  and  superclasses. 


Do  constructors  have  to  bo  public? 


No.  Constructors  can  be  public, 
private,  or  default  (which  means  no  access 
modifier  at  all), We’ll  look  more  at  default 
access  in  chapter  16  and  appendix  B. 


How  could  a private  constructor 
ever  be  useful?  Nobody  could  ever  call  It, 
so  nobody  could  ever  make  a new  objectl 


But  that's  not  exactly  right.  Marking 
something  private  doesn't  mean  nobody 
can  access  It,  it  Just  means  that  nobody 
outside  the  class  can  access  it.  Bet  you're 
thinking  "Catch  22"  Only  code  from  the 
same  class  as  the  class-with-private-con- 
structor  can  make  a new  object  from  that 
class,  but  without  first  making  an  object, 
how  do  you  ever  get  to  run  code  from  that 
class  in  the  first  place?  How  do  you  ever  get 
to  anything  in  that  class?  Patience  grasshop- 
per. We’ll  get  there  in  the  next  chapter. 
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space  for  an  object’s  superclass  parts 

Walt  a minute...  m never  PIP  talk  about 
superclasses  and  inheritance  and  how  that  all 
fits  in  with  constructors. 

Here's  where  it  gets  fun.  Remember  from  the  last  chapter,  the  part  where  we  looked  at 
the  Snowboard  object  wrapping  around  an  inner  core  representing  the  Object  portion 
of  the  Snowboard  class?  The  Big  Point  there  was  that  every  object  holds  not  just  its  own 
declared  instance  variables,  but  also  everything  from  its  superclasses  (which,  at  a minimum, 
means  class  Object,  since  every  class  extends  Object) . 

So  when  an  object  is  created  (because  somebody  said  new;  there  is  no  other  way  to  create 
an  object  other  than  someone,  somewhere  saying  new  on  the  class  type),  the  object 
gets  space  for  all  the  instance  variables,  from  all  the  way  up  the  inheritance  tree.  Think 
about  it  for  a moment...  a superclass  might  have  setter  methods  encapsulating  a private 
variable.  But  that  variable  has  to  live  somewhere  When  an  object  is  created,  it's  almost  as 
though  multiple  objects  materialize — the  object  being  new'd  and  one  object  per  each 
superclass.  Conceptually,  though,  it's  much  better  to  think  of  it  like  the  picture  below, 
where  the  object  being  created  has  layers  of  itself  representing  each  superclass. 


Object 

Foo  a; 

intb; 

intc; 


equalsf) 

getClassQ 

hashCodeO 

toStringO 


r 

Snowboard  | 

Fgox 

Fooy 

Hz 

□ 

tumO 

shredO 

getAlrQ 

IcaeControlQ 


Object  K 3s  instance  variables 
encapsulated  by  access  methods- 
Those  instance  variables  are 
t\rtabed  when  any  subclass  is 
instantiated-  (These  aren't  the 
RBflL  Object  variables,  but  we 
don't  care  what  they  are  since 
they're  encapsulated) 

Snowboard  also  has  instance 
variables  of  its  own,  so  to  make 
a Snowboard  object  we  need 
space  for  the  instance  variables 
of  both  classes. 


A single 


There  is  only  ONfc  object  on  the  heap  here-  A 
Snowboard  object.  But  it  Contains  both  the 
Snowboard  parts  of  itself  and  the^)b\ect  parts  of 
itself-  AH  instance  variables  from  both  classes  have 
to  be  here- 
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The  role  of  superclass  constructors 
In  an  object's  life. 


AH  the  constructors  in  an  object's  inheritance 
tree  must  run  when  you  make  a new  object 
Let  that  sink  in. 


A new  Hippo  object  also  IS-A  Animal 
and  IS-A  Object.  If  you  want  to  make  a 
Hippo,  you  must  also  make  the  Animal 
and  Object  parts  of  the  Hippo. 


That  means  every  superclass  has  a constructor 
(because  every  class  has  a constructor),  and  each 
constructor  up  the  hierarchy  runs  at  the  time  an 
object  of  a subclass  is  created. 

Saying  new  is  a Big  Deal.  It  starts  the 
whole  constructor  chain  reaction.  And  yes, 
even  abstract  classes  have  constructors. 

Although  you  can  never  say  new  on  an 
abstract  class,  an  abstract  class  is  still 
a superclass,  so  its  constructor  runs 
when  someone  makes  an  instance  of  a 
concrete  subclass. 


The  super  constructors  run  to  build 
out  the  superclass  parts  of  the  object. 

Remember,  a subclass  might  inherit 
methods  that  depend  on  superclass  state 
(in  other  words,  the  value  of  instance  variables 
in  the  superclass).  For  an  object  to  be  fully- 
formed,  all  the  superclass  parts  of  itself  must  be 
fully-formed,  and  that's  why  the  super  constructor 
must  run.  All  instance  variables  from  every  class 
in  the  inheritance  tree  have  to  be  declared  and 
initialized.  Even  if  Animal  has  instance  variables 
that  Hippo  doesn't  inherit  (if  the  variables  are 
private,  for  example),  the  Hippo  still  depends  on 
the  Animal  methods  that  use  those  variables. 


This  all  happens  In  a process  called 

When  a constructor  runs,  it  immediately  calls  its  Constructor  Chaining 

superclass  constructor,  all  the  way  up  the  chain 
until  you  get  to  the  class  Object  constructor. 


On  the  next  few  pages,  you’ll  learn  how  superclass 
constructors  are  called,  and  how  you  can  call 
them  yourself.  You'll  also  learn  what  to  do  if  your 
superclass  constructor  has  arguments! 
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Making  a Hippo  means  making  the 
Animal  and  Object  parts  too... 


public  class  Animal  ( 
public  Animal  ()  { 

System . out . pr intin  ( "Malting  an  Animal") ; 

) 

) 


public  class  Hippo  extends  Animal  { 
public  Hippo  0 { 

Sys  tarn.  out  -pr  in  tin  (“Making  a Hippo  ")  ; 

} 

) 


public  class  TestHippo  { 

public  static  void  main  (String  I]  args ) ( 
System. out .println( "Star ting.  . . ")  ; 
Hippo  h = new  Hippo  ()  ; 

} 

) 


What's  the  real  output?  Given  the 
code  on  the  left,  what  prints  out 
when  you  run  TestHippo?  A or  B? 


(the  answer  Is  at  the  bottom  of  the  page) 


| Rle  Edit  Wfndow  Help  Swear 

% java 

Te 

stHippo 

Starting. 

- - 

Making 

an 

Animal 

Making 

a 

Hippo 

| m Edli  VWndow  Help  Swear 

% java 

Te 

stHippo 

Starting. 

- - 

Making 

a 

Hippo 

Making 

an 

Animal 

Code  from  another 


class  says  new 
Hippo  ()and  the 
HfppoQ  constructor 
goes  into  a stack 
frame  at  the  top  of 
the  stack. 


&H(ppoO  invokes 
the  superclass 
constructor  which 
pushes  the  AnlmalO 
constructor  onto  the 
top  of  the  stack. 


^ An!mal()  invokes 
the  superclass 
constructor  which 
pushes  the  Object() 
constructor  onto 
the  top  of  the  stack, 
since  Object  is  the 
superclass  of  Animal. 


ObjectO  completes, 
and  its  stack  frame 
is  popped  off  the 
stack,  Execution  goes 
back  to  the  Anlmal() 
constructor,  and 
picks  up  at  the  line 
following  Animal's 
call  to  its  superclass 
constructor 
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How  do  you  invoke  a superclass  constructor? 
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You  might  think  that  somewhere  in,  say,  a Duck  constructor, 
if  Duck  extends  Animal  you'd  call  Animal  ().  But  that's  not 
how  it  works: 

public  class  Duck  extends  Animal  { 
int  size; 


public  Duck (int  newSize)  { 

Animal  ()  ; <- 

size  = newSize; 

> 


N°f  * 


hei  /eja// 


The  only  way  to  call  a super  constructor  is  by  calling  super (). 
That's  right — super ()  calls  the  super  constructor. 

What  are  the  odds? 

public  class  Duck  extends  Animal  { 
int  size; 


public  Duck (int  newSize)  { 


super ();  « 

size  = newSize; 


) 


1 


A call  to  superQ  in  your  constructor  puts  the  superclass 
constructor  on  the  top  of  the  Stack.  And  what  do  you 
think  that  superclass  constructor  does?  Calls  its  superclass 
constructor.  And  so  it  goes  until  the  Object  constructor  is 
on  the  top  of  the  Stack.  Once  ObjectO  finishes,  it’s  popped 
off  the  Stack  and  the  next  thing  down  the  Slack  (die 
subclass  constructor  that  called  Objed())  is  now  on  top. 
That  constructor  finishes  and  so  it  goes  until  the  original 
constructor  is  on  the  top  of  the  Stack,  where  it  can  now 
finish. 


And  how  is  it  that  we’ve 
gotten  away  without 
doing  it? 

You  probably  figured  that  out. 

Our  good  friend  the  compiler 
puts  in  a call  to  super()  if  you 
don't. 

So  the  compiler  gets  Involved  In 
constructor-making  In  two  ways: 

(?)  If  you  don't  provide  a constructor 

The  compiler  puts  one  in  that  looks  like: 

public  Cl&ssNamaO  { 
super  ()  ; 

) 

(2)  If  you  do  provide  a constructor 
but  you  do  not  put  in  the  call  to 
super() 

The  compiler  will  put  a call  to  super()  In 
each  of  your  overloaded  constructors/ 

The  compiler-supplied  call  looks  like: 

super  ()  ; 

it  always  looks  like  that.  The  compiler- 
inserted  call  to superQ  Is  always  a no-arg 
call.  If  the  superclass  has  overloaded 
constructors,  only  the  no-arg  one  is  called. 

"Unless  the  constructor  calls  another  overloaded 
constructor  (you'll  see  that  in  a few  pages). 
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Can  the  child  exist  before 


^ Eewwww,..  that 
is  SO  creepy.  There's 
no  way  I could  have  been 
born  before  my  parents. 
That's  just  wrong. 


the  parents? 


If  you  think  of  a superclass  as  the  parent  to  the  subclass  child, 
you  can  figure  out  which  has  to  exist  first.  The  superclass  parts 
of  an  object  have  to  be  JuUy-formed  (completely  built)  before  the 
subclass  parts  can  be  constructed  Remember, 
the  subclass  object  might  depend  on  things  it 
inherits  from  the  superclass,  so  it's  important 
that  those  inherited  things  be  finished.  No 
way  around  it.  The  superclass  constructor 
must  finish  before  its  subclass  constructor. 


Look  at  the  Stack  series  on  page  248  again, 
and  you  can  see  that  while  the  Hippo 
constructor  is  the  first  to  be  invoked  (it's 
the  first  thing  on  the  Stack),  it’s  the  last  one 
to  complete!  Each  subclass  constructor 
immediately  invokes  its  own  superclass 
constructor,  until  the  Object  constructor 
is  on  the  top  of  the  Stack.  Then  Object's 
constructor  completes  and  we  bounce 
back  down  the  Stack  to  Animal's 
constructor.  Only  after  AjiimaTs  constructor  completes 
do  we  finally  come  back  down  to  finish  the  rest  of  the  Hippo 
constructor.  For  that  reason: 


The  call  to  super()  must  be  the  first  statement 
In  each  constructor!* 


There's  an  exception  to  this  rule;  you’ll  learn  It  on  page  252. 
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Superclass  constructors  with  arguments 


What  if  the  superclass  constructor  has  arguments?  Can  you  pass  something  in  to 
the  super()  call?  Of  course.  If  you  couldn't*  you'd  never  be  able  to  extend  a class 
that  didn't  have  a no-arg  constructor.  Imagine  this  scenario:  all  animals  have  a 
name.  There's  a gelName()  method  in  class  Animal  that  returns  the  value  of  the 
name  instance  variable.  The  instance  variable  is  marked  private,  but  the  subclass 
(in  this  case,  Hippo)  inherits  the  getName()  method.  So  here’s  the  problem: 

Hippo  has  a getName()  method  (through  inheritance),  but  does  not  have  the  name 
instance  variable.  Hippo  has  to  depend  on  the  Animal  pan  of  himself  to  keep  the 
name  instance  variable,  and  return  it  when  someone  calls  geiNamef)  on  a Hippo 
object.  But...  how  does  the  Animal  part  get  the  name?  The  only  reference  Hippo 
has  to  the  Animal  part  of  himself  is  through  super()>  so  that’s  the  place  where 
Hippo  sends  the  Hippo's  name  up  to  the  Animal  part  of  himself,  so  that  the 
Animal  part  can  store  it  in  the  private  name  instance  variable. 

public  abstract  class  Animal  { 

private  String  name;  A Al' 

subclasses)  have  * 

public  String  getName  ()  ( ^ A 

return  name;  Wippo 


Animal 


private  String  name 


Animal($tring  n) 


String  getNameO 


Hippo 


Hlppo($tring  n) 


[other  Hlppo-spe~ 
clfic  methods} 


) 


public  Animal  (String  theName)  ( 
name  = theName ; 

^ ~ .J  J _ 


} 


‘I  he  v 
wriab|e 


public  class  Hippo  extends  Animal  ( 


public  Hippo (String  name)  { 
super  (name)  ; 

> 


Co* 


i sendi  f k,  . 


public  class  MakeHippo  ( 

public  static  void  main (String[]  args)  ( Make  a 

Hippo  h = new  Hippo  ( "Buff y" ) ; < "Buf/j 

toKsirusJ.^  '-r,  Wppo 

System. out. println(h.getName()  ) ; u , Thc*  ta\\  fL. 

, i <=■ PP‘ “ "'"'■t*  vtNiJ) 


| Rte  Edit  Window  Help  Hide  1 


%java  MakeHippo 
Buf  fy 
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■onstructor  Irom  anoW 

0ve.WeJ  constructor 

tl,c  same  class. 

TW  call  to  tltisO 
can  l>e  usd  only  in  a 

constructor,  ad  must 

I iV  lirst  statement  n 

l constructor. 

I A constructor  ca^  ^ 
I call  to  superl)  OR 
I l,ul  never  l>oth. 


Invoking  one  overloaded  constructor 
from  another 


What  if  you  have  overloaded  constructors  that,  with 
the  exception  of  handling  different  argument  types, 
all  do  the  same  thing?  You  know  that  you  don’t  want 
duplicate  code  sitting  in  each  of  the  constructors  (pain 
to  maintain,  etc.),  so  you’d  like  to  put  the  bulk  of  the 
constructor  code  (including  the  call  to  super() ) in  only 
one  of  the  overloaded  constructors.  You  want  whichever 
constructor  is  first  invoked  to  call  The  Real  Constructor 
and  let  The  Real  Constructor  finish  the  job  of 
construction.  It’s  simple:  just  say  this().  Or  this(aString). 
Or  this(27,  x).  In  other  words,  just  imagine  that  the 
keyword  this  is  a reference  to  the  current  object 

You  can  say  this()  only  within  a constructor,  and  it  must 
be  the  first  statement  in  the  constructor! 

But  that’s  a problem,  isn’t  it?  Earlier  we  said  that 
super()  must  be  the  first  statement  in  the  constructor. 
Well,  that  means  you  get  a choice. 

Every  constructor  can  have  a call  to  superQ 
or  thls()y  but  never  bothl 


class  Mini  extends  Car  { 


Color  color; 

public  Mini[)  { 

this (Color , Red) ; 

) 


I o*  ovo-uad 


public  Mini (Color  c)  { 

super(uMini")  ; ^ 

color  - c; 


it  more  initialization 


P1'1  Seal  tkat 


) 


public  Mini(int  size)  { 

this (Color . Rad) J 
super  (size)  ; work//  Ca*i  hav* 

^ two  ^ 

> tKey  J 


| File  Edll  Window  Help  Driva 

javac  Mini . java 

Mini . java ; 16 : call 

to  super  must 

be  first  statement 

in  constructor 

super ( ) ; 

A 
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Some  of  t he  constructors  In  the  SonOfBoo  class  will  not 
compile.  See  rf  you  can  recognize  which  constructors  are 
not  legal.  Match  the  compiler  errors  with  the  SonOfBoo 
constructors  that  caused  them,  by  drawing  a line  from  the 
compiler  error  to  thewbadMcon$tructor. 

public  class  Boo  { 

public  Boo (int  i)  ( \ 
public  Boo (String  s)  { } 
public  Boo (String  s,  int  i)  { ) 

) 


class  SonOfBoo  extends  Boo  { 

public  SonOfBoo (>  ( 
super ("boo") ; 

} 

public  SonOfBoo (int  1)  ( 
super ("Fred") ; 

) 

public  SonOfBoo (String  a)  { 
super (42) ; 

) 

public  SonOfBoo(int  i,  String  s)  { 

) 

public  SonOfBoo (String  a,  String  b.  String  c) 
super (a,b) ; 

) 

public  SonOfBoo (int  i,  int  j)  { 
super  ("man" , j ) ; 

) 

public  SonOfBoo(int  i,  int  x,  int  y)  ( 
super (i,  "star") ; 

) 


%javac  SonOfBoo * java 
cannot  resolve  symbol 

symbol  : constructor  Boo 

{ j ava . lang . String , java . la 
ng . String) 


{ 


I Re  Edit  Window  Help  ImNoUJstenlnq 

javac 

SonOfBoo . java 

canno  t 

resolve  symbol 

symbol ; 

: constructor  Boo ( ) 

Re  EdH  Window  Help  Yadayadayade 


% javac  SonOfBoo. java 

cannot  resolve  symbol 

symbol  : constructor  Boo 
(int , java . lang . String) 
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Now  we  know  how  an  object  is  born, 
but  how  long  does  ah  object  live ? 


An  object's  life  depends  entirely  on  the  life  of  references 
referring  to  iL  If  the  reference  is  considered  “alive”,  the 
object  is  still  alive  on  the  Heap.  If  the  reference  dies 
(and  we’ll  look  at  vvbat  that  means  in  just  a moment),  the 
object  will  die. 

So  if  an  object^  life  depends  on  the  reference 
variable’s  life,  how  long  does  a variable  live? 

That  depends  on  whether  the  variable  is  a local  variable 
or  an  instance  variable.  The  code  below  shows  the  life  of  a 
local  variable.  In  the  example,  the  variable  is  a primitive, 
but  variable  lifetime  is  the  same  whether  it's  a primitive 
or  reference  variable, 

public  class  TestLifeOne  { 


public  void  read() 

int  s = 42;  ^ 

sleep  0 ; 

) 


) 


public  void  sleep () 
s = 7; 


***** 


< 


a v.*o* 


Tk 

he  bie  n . 

'r&d0  , (s  *llve,  ya  ■ 

' * - 


@ A local  variable  lives  only 
within  the  method  that 
declared  the  variable. 

public  void  raad()  ( 
int  s = 42; 

//  's'  oan  be  used  only 

//  within  this  method. 

II  When  this  method  ends, 

//  's'  disappears  completely. 

) 

Variable  V can  be  used  only  within  the 
read()  method.  In  other  words,  the  variable 
Is  In  scope  only  within  its  own  method.  No 
other  code  in  the  class  (or  any  other  class) 
can  see's'. 


^ An  in  stance,  variable  lives 
as  long  as  the  object 
does.  Iff  the  object  is  still 
alive,  so  are  its  instance 
variables. 

public  class  Life  { 
int  size; 

public  void  setSizefint  s)  { 
size  = s ; 

//  's'  disappears  at  the 
II  end  of  this  method, 

//  but  'size'  can  be  used 
//  anywhere  in  the  class 

) 

) 

Variable 's' (this  time  a method  parameter) 

Is  In  scope  only  within  the  setSizeO 
method.  8ut  instance  variable  size  is 
scoped  to  the  life  of  the  object  as  opposed 
to  the  life  of  the  method . 
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The  difference  between  life  and 
scope  for  local  variables: 

Life 

Aloca]  variable  is  alive  as  long  as  its  Stack 
frame  is  on  the  Stack.  In  other  words, 
until  the  method  completes . 

Scope 

A local  variable  is  in  scope  only  within  the 
method  in  which  the  variable  was  declared. 
When  its  own  method  calls  another,  the 
variable  is  alive,  but  not  in  scope  until  its 
method  resumes.  You  can  use  a variable  only 
when  it  is  in  scope. 


public  void  doStuffO  { 
boolean  b = true; 
go (4)  ; 

> 

publio  void  go(±nt  x)  { 
int  z = x + 24; 
crazy () ; 

//  imagine  more  code  here 

1 

public  void  crazy ()  ( 

char  c ™ 'a' ; 

) 


A doStuffO  goes  on  the 
Stack  Variable  V is 
alive  and  In  scope. 


o 


goQ  plops  on  top  of 
the  Stacie.  V and 
are  alive  and  in  scope, 
and  V Is  alive  but  nof 
in  scope. 


crazyO  is  pushed  onto 
the  Stack,  with  V now 
alive  and  In  scope.  The 
other  three  variables 
are  alive  but  out  of 
scope. 


While  a local  variable  is  alive,  its  state  persists. 

As  long  as  method  doStuffO  is  on  the  Stack,  for 
example,  the  V variable  keeps  its  value.  But  the 
'b'  variable  can  be  used  only  while  doStu£f()  s 
Stack  frame  is  at  the  top.  In  other  words,  you  can 
use  a local  variable  only  while  that  local  variable's 
method  is  actually  running  (as  opposed  to 
waiting  for  higher  Stack  frames  to  complete). 


crazyO  completes  and 
^ Is  popped  off  the  Stack, 
so  V is  out  of  scope 
and  dead.  When  goQ 
resumes  where  It  left 
off,  V and  lz'  are  both 
alive  and  back  In  scope. 
Variable  V Is  still  alive 
but  out  of  scope  (until 
goO  completes). 
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What  about  reference  variables? 


The  rules  are  the  same  for  primtives  and  references.  A reference 
variable  can  be  used  only  when  it's  in  scope*  which  means  you  can't  use 
an  object's  remote  control  unless  you've  got  a reference  variable  that's 
in  scope*  The  ^question  is, 

“How  does  variable  life  affect  object  life?” 

An  object  is  alive  as  long  as  there  are  live  references  to  iL  If  a reference 
variable  goes  out  of  scope  but  is  still  alive,  the  object  it  refers  to  is  still 
alive  on  the  Heap.  And  then  you  have  to  ask*..  “What  happens  when  the 
Stack  frame  holding  the  reference  gets  popped  off  the  Stack  at  the  end 
of  the  method?” 

If  that  was  the  only  live  reference  to  the  object,  the  object  is  now 
abandoned  on  the  Heap.  The  reference  variable  disintegrated  with 
the  Stack  frame,  so  the  abandoned  object  is  now,  officially , toast  The 
trick  is  to  know  the  point  at  which  an  object  becomes  eligible  for  garbage 
collection. 


An  object’s  life  has  no 
value,  no  meaning,  no 
point,  unless  somebody 
has  a reference  to  it 

If  you  can’t  get  to  it 
you  can’t  ask  it  to  do 
anything  and  it’s  just  a 
big  fat  waste  of  bits. 

But  if  an  objeet  is 
unreachable,  the 


Once  an  object  is  eligible  for  garbage  collection  (GC),  you  don’t  have 
to  worry  about  reclaiming  the  memory  that  object  was  using.  If  your 
program  gets  low  on  memory,  GC  will  destroy  some  or  all  of  the  eligible 
objects,  to  keep  you  from  running  out  of  RAM.  You  can  sdll  run  out  of 
memory,  but  not  before  all  eligible  objects  have  been  hauled  off  to  the 
dump.  Yourjob  is  to  make  sure  that  you  abandon  objects  (i.e,  make 
them  eligible  for  GC)  when  you're  done  with  them,  so  that  the  garbage 
collector  has  something  to  reclaim.  If  you  hang  on  to  objects,  GC  can’t 


Garbage  Collector  will 
figure  that  out  Sooner 
or  later,  that  object’s 
goin’  down. 


help  you  and  you  run  the  risk  of  your  program  dying  a painful 
out-of-memory  death. 


An  object  becomes 
eligible  for  GC  when 
its  last  live  reference 
disappears. 


Three  ways  to  get  rid  of  an  object’s  reference: 


The  reference  goes  out  of  scope,  permanently  , 

. - /v  , - ^ dies  at 

void  go  ()  { t 

Life  z = new  Life()  ; ^ ft 

(2)  The  reference  is  assigned  another  object  k 

Life  z = new  Life  ()  ; , 

z - new  Life  ( ) ; ^ — ^en  z- 

3 *C*> 

(?)  The  reference  is  explicitly  set  to  null  . . 

Life  z = new  Life()  ; 
z - null;  ^ 
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Object-killer  #1 


Reference  goes 
out  of  scope, 
permanently. 


public  class  StackHof  { 
public  void  foof()  { 
barf  ()  ; 

} 

public  void  barf  ()  { 

Duck  d = now  Duck ( ) ; 

) 

} 


foofQ  Is  pushed  onto  the 
Stack,  no  variables  are 
declared. 


barf()  Is  pushed  onto  the 
Stack,  where  It  declares 
a reference  variable,  and 
creates  a new  object  as- 
signed to  that  reference. 
The  object  Is  created  on 
the  Heap,  and  the  refer- 
ence Is  alive  and  In  scope. 


.WrW 

£eci+u- 


. VVit 


barfQ  completes  and  pops 
off  the  Stack.  Its  frame 
disintegrates,  so 'd'  is  now 
dead  and  gone.  Execution 
returns  to  foofQ , but  foofQ 
can’t  use  ‘d’ . 


Mh— ©h.  The  d variable 
wc*t  away  when  the  barfO 
^tack  IVame  was  blown 
the  rbek,  to  the  Duek 
ii  abandoned,  ^jarba^e- 
Collector  bait 
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Object-killer  #2 


Assign  the  reference 
to  another  object  A 


Dude,  all  you 
had  to  do  was  reset 
the  reference,  6uess 
they  didn't  have  memory 
management  back  then, 


public  class  Re Ref  { 


Duck  d = new  Duck() 


public  void  go()  { 
d = new  Duck  ()  ; 


% the  Heap,  referenced 
instate  variable,  the 

as  the  ReRe-f  objefrt 
is  alive-  Unless— 


U)  nM"**  ^ 

W^d-  Vh»  o*W 

^sb«* 
differed  R* 


e$ef  obi®^ 


ld’  is  assigned  a new  Duik  objeet,  Ita** _tbe 
original  (-first)  Duek  objeet  abandoned-  That 
first  Duek  is  now  as  $*»d  as  dead- 
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Object-killer  #3 


Explicitly  sat  the 
reference  to  null 


public  class  ReRaf  { 

Duck  d = flat#  Duck  ( ) ; 

public  void  go<)  { 
d - null; 

} 


The  meaning  of  null 

When  you  seta  reference  to  null,  you're 
deprogramming  the  remote  control. 

In  other  words,  you've  got  a remote 
control  but  noTV  at  the  other  end.  A null 
reference  has  bits  representing 'null' (we 
don't  know  or  care  what  those  bits  are,  as 
long  as  the  JVM  knows). 

If  you  have  an  unprogrammed  remote 
control,  In  the  real  world,  the  buttons  don't 
do  anything  when  you  press  them.  But 
in  Java,  you  can't  press  the  buttons  (Le. 
use  the  dot  operator)  on  a null  reference, 
because  the  JVM  knows  (this  Is  a runtime 
Issue,  not  a compiler  error)  that  you're 
expecting  a bark  but  there's  no  Dog  there 
todottl 

If  you  use  the  dot  operator  on 
a null  reference/you/llgeta 
NullPoInterExceptlon  at  runtime.  You'll 
learn  all  about  Exceptions  In  the  Risky 
Behavior  chapter. 


* ^ Dvik  3oes  o*  tbe  refereed 
V-  Si***  'd'  « a*  mtiaue  variable,  tKe 
will  live  a*  a*  the  ReRe*  °bjett 

i.  I / I 


s *rt  to  wll,  wbieK  i*  j<*t  like  bav*5  a 

brol  that  Wt  Y-*  « r* 

, allied  to  ue  tbe  dot  cftrab*-  «.  d «t* 


oA  i 
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Fireside  Chats 


Tonight’s  Talk:  An  instance  variable  and 
a local  variable  discuss  life  and  death 
(with  remarkable  civility) 


Instance  Variable 

I’d  like  to  go  first,  because  I tend  to  be  more 
important  to  a program  than  a local  variable. 
I’m  there  to  support  an  object,  usually 
throughout  the  object’s  entire  life.  After  all, 
what’s  an  object  without  state?  And  what  is 
state?  Values  kept  in  instance  variables. 


No,  don ’t  get  me  wrong,  I do  understand  your 
role  in  a method,  it's  just  that  your  life  is  so 
short.  So  temporary.  That's  why  they  call  you 
guys  “temporary  variables”. 

My  apologies.  I understand  completely. 


I never  really  thought  about  it  like  that.  What 
are  you  doing  while  the  other  methods  are 
running  and  you're  waiting  for  your  frame  to 
be  the  top  of  the  Stack  again? 


Local  Variable 


I appreciate  your  point  of  view,  and  I certainly 
appreciate  the  value  of  object  state  and  all, 
but  I don’t  want  folks  to  be  misled.  Local 
variables  are  really  important.  To  use  your 
phrase,  “After  all,  what’s  an  object  without 
behavior?"  And  what  is  behavior?  Algorithms 
in  methods.  And  you  can  bet  your  bits  there’ll 
be  some  local  variables  in  there  to  make  those 
algorithms  work. 

Within  the  local-variable  community,  the 
phrase  “temporary  variable”  is  considered 
derogatory.  We  prefer  “local”,  “stack”,  “auto- 
matic”, or  ’’Scope-challenged'7. 

Anyway,  it’s  true  that  we  don't  have  a Jong 
life,  and  it’s  not  a particularly  good  life  either. 
First,  we’re  shoved  into  a Stack  frame  with 
all  the  other  local  variables.  And  then,  if  the 
method  we’re  part  of  calls  another  method, 
another  frame  is  pushed  on  top  of  us.  And  if 
that  method  calls  another  method...  and  so  on. 
Sometimes  we  have  to  wait  forever  for  all  the 
other  methods  on  top  of  the  Stack  to  corm 
plele  so  that  our  method  can  run  again. 

Nothing.  Nothing  at  all.  It’s  like  being  in 
stasis — that  thing  they  do  to  people  in  science 
fiction  movies  when  they  have  to  travel  long 
distances.  Suspended  animation,  really.  We 
just  sit  there  on  hold.  As  long  as  our  frame  is 
still  there,  we’re  safe  and  the  value  we  hold 
is  secure,  but  it's  a mixed  blessing  when  our 
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Instance  Variable 


We  saw  an  educational  video  about  it  once. 
Looks  like  a pretty  brutal  ending.  I mean, 
when  that  method  hits  its  ending  curly  brace, 
the  frame  is  literally  blown  off  the  Stack!  Now 
that’s  % otta  hurt. 


I live  on  the  Heap,  with  the  objects.  Well,  not 
with  the  objects,  actually  in  an  object.  The 
object  whose  state  I store.  I have  to  admit  life 
can  be  pretty  luxurious  on  the  Heap.  A lot  of 
us  feel  guilty,  especially  around  the  holidays. 


OK,  hypothetically,  yes,  if  I’m  an  instance 
variable  of  the  Collar  and  the  Collar  gets 
GC’d,  then  the  Collar’s  instance  variables 
would  indeed  be  tossed  out  like  so  many  pizza 
boxes.  But  I was  told  that  this  almost  never 
happens. 


They  let  us  drink ? 


Local  Variable 

frame  gets  to  run  again.  On  the  one  hand,  we 
get  to  be  active  again.  On  the  other  hand,  the 
clock  starts  ticking  again  on  our  short  lives. 
The  more  time  our  method  spends  running, 
the  closer  we  get  to  the  end  of  the  method. 

We  all  know  what  happens  then. 

Tell  me  about  it.  In  computer  science  they  use 
the  term  popped  as  in  “the  frame  was  popped 
off  the  Stack".  That  makes  it  sound  fun,  or 
maybe  like  an  extreme  sport.  But,  well,  you 
saw  the  footage.  So  why  don’t  we  talk  about 
you?  I know  what  my  little  Stack  frame  looks 
like,  but  where  do  you  live? 


But  you  don’t  always  live  as  long  as  the  object 
who  declared  you,  right?  Say  there’s  a Dog 
object  with  a Collar  instance  variable.  Imagine 
you  ’re  an  instance  variable  of  the  Collar  object, 
maybe  a reference  to  a Buckle  or  something, 
sitting  there  all  happy  inside  the  Collar  object 
who’s  all  happy  inside  the  Dog  object.  But... 
what  happens  if  the  Dog  wants  a new  Collar, 
or  nulls  out  its  Collar  instance  variable?  That 
makes  the  Collar  object  eligible  for  GC.  So... 
if  you’re  an  instance  variable  inside  the  Collar, 
and  the  whole  Collar  is  abandoned,  what 
happens  to  you ? 


And  you  believed  it?  That’s  what  they  say  to 
keep  us  motivated  and  productive.  But  aren’t 
you  forgetting  something  else?  What  if  you’re 
an  instance  variable  inside  an  object,  and  that 
object  is  referenced  only  by  a local  variable?  If 
I’m  the  only  reference  to  the  object  you’re  in, 
when  I go,  you’re  coming  with  me.  Like  it  or 
not,  our  fates  may  be  connected.  So  I say  we 
forget  about  all  this  and  go  get  drunk  while 
we  still  can.  Carpe  RAM  and  all  that. 
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BE  tke  Garbage  Collector 

Which  of  -fiie  lines  of  code  on  the  right,  if  added 
to  the  class  on  -die  left  at  point  A,  would  cause 
exactly  one  additional  object  to  be  eligible  for  the 
Garbage  Collector?  (Assume  that  point  A (//call 
more  methods)  will  execute  for  a long  time,  giving  the 
Garbage  Collector  time  to  do  its  staff.) 


public  class  GC  { 

public  static  GC  doStuffO  { 


GC  newGC  = new  GC 0 ; 

1 

copyGC  = null; 

doStuff2 (newGC) ; 

return  newGC; 

} 

2 

gc2  = null; 

3 

newGC  = gc3; 

public  static  void  main (String 

U args)  { 

GC  gel; 

4 

gel  = null; 

GC  gc2  = new  GC  0 ; 

GC  ge3  = new  GC  0 ; 

5 

newGC  = null; 

GC  gc4  * gc3; 

gel  = doStuff  0 ; 

6 

gc4  = null; 

Q 

7 

gc3  = gc2; 

i ! call  more  methods 

} 

8 

gel  = gc4 ; 

public  static  void  doStuff2 (GC 

copyGC)  ( 

9 

gc3  = null; 

GC  localGC 

) 
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class  Bees  { 

Honey  [ ] beeHA; 

> 


In  this  code  example,  several  new  objects  are  created. 
Your  challenge  is  to  find  the  object  that  is  'most  popular', 
r.e.  the  one  that  has  the  most  reference  variables  referring 
to  it.  Then  list  how  many  total  references  there  are  for 
that  object, and  what  they  are!  We'll  start  by  pointing  out 
one  of  the  new  objects,  and  its  reference  variable. 

Good  Luck) 


class  Raccoon  { 
Kit  k; 

Honey  rh; 

> 

class  Kit  ( 
Honey  kh; 

> 

class  Bear  { 
Honey  hunny; 

> 


public  class  Honey  { 

public  static  void  main (String  []  args)  { 

Honey  honeyPot  - new  Honey(); 

Honey  [ ] ha  = { honeyPot , honeyPot,  honeyPot,  honeyPot); 
Bees  bl  = new  Bees(); 
bl.beeRA  = ha; 

Bear  [ ) ba  = new  Bear[5]; 
for  (int  x-0;  x < 5;  x++)  { 
bafx]  = new  Bear( ) ; 
ba(x].hunny  - honeyPot; 


> 

Kit  k = new  Kit ( ) ; 
k.kh  = honeyPot; 

Raccoon  r » new  Raccoon ( ) 


Here's  a new 
Raccoon  object! 


r.rh  = honeyPot; 


r»k  = k; 


Here's  Its  reference 
variable  *r\ 


k = null; 

) //  end  of  main 


> 
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puzzle:  Five  Minute  Mystery 


Flve-J^nufe 

Mystery 


“We’ve  run  the  simulation  four  times,  and  the  main  module’s  temperature  consistently 
drifts  out  of  nominal  towards  cold",  Sarah  said,  exasperated.  “We  installed  the  new  temp-bots  last 
week.  The  readings  on  the  radiator  bots,  designed  to  cool  the  living  quarters,  seem  to  be  within 
spec,  so  we’ve  focused  our  analysis  on  the  heat  retention  bots,  the  bots  that  help  to  warm  the  quar- 
ters " Tom  sighed,  at  first  it  had  seemed  that  nano-technology  was  going  to  really  put  them  ahead 
of  schedule.  Now,  with  only  five  weeks  left  until  launch,  some  of  the  orbiter’s  key  life  support 
systems  were  still  not  passing  the  simulation  gauntlet. 

“What  ratios  are  you  simulating?",  Tom  asked. 

,fWell  if  I see  where  you’re  going,  we  already  thought  of  that",  Sarah  replied.  “Mis- 
sion control  will  not  sign  off  on  critical  systems  if  we  run  them  out  of  spec.  We  are 
required  to  run  the  v3  radiator  bot’s  SimUnits  in  a 2: 1 ratio  with  the  v2  radiator’s 
SimUnits",  Sarah  continued.  “Overall,  the  ratio  of  retention  bots  to  radiator  bots  is 
supposed  to  run  4:3." 


lfHow’s  power  consumption  Sarah?",  Tom  asked.  Sarah  paused,  “Well  that’s 
another  thing,  power  consumption  is  running  higher  than  anticipated.  We’ve  got  a team 
tracking  that  down  too,  but  because  the  nanos  are  wireless  it’s  been  hard  to  isolate  the  power 
consumption  of  the  radiators  from  the  retention  bots."  “Overall  power  consumption  ratios",  Sarah 
continued,  “are  designed  to  run  3:2  with  the  radiators  pulling  more  power  from  the  wireless  grid  " 

“OK  Sarah",  Tom  said  “Let’s  take  a look  at  some  of  the  simulation  initiation  code. 

We’ve  got  to  find  this  problem,  and  find  it  quick!" 


import  java. util.*; 
class  V2Radiator  { 

V2Radiator (ArrayList  list)  { 
for(int  x«0;  x<5;  x-m-)  { 

list. add( new  SimUnit( "V2Radiator" ) ) ; 

> 


> 


class  V3Radiator  extends  V2Radiator  { 
V3Radiator (ArrayList  lglist)  { 
super ( lglist) ; 
for  ( int  g~0;  g<10j  g-M-)  { 

lglist. add (new  SimUnit ( “V3 Radi a tor" ) ) ; 

) 

) 


class  RetentionBot  { 

RetentionBot (ArrayList  rlist)  { 

rlist . add(new  SimOnit( "Retention’ ) ) ; 

) 

) 
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Flve-jspnufe 

Mystery 

continue!.. 


public  class  TestLifeSupportSim  { 

public  static  void  main (String  []  args)  { 
ArrayList  aList  = new  ArrayList( ) ? 

V2Radiator  v2  = new  V2Radiator (aList) ; 
V3Radiator  v3  = new  V3Radiator ( aList ) ; 
for(int  z=0;  z<20;  z++)  { 

RetentionBot  ret  = new  RetentionBot ( aList ) ; 

} 

} 


class  SimUnit  { 

String  botType; 

SimUnit (String  type)  { 
botType  = type; 

> 

int  powerUse ( ) { 

if  ("Retention". equals (botType) ) { 
return  2 ; 

> else  { 
return  4; 

} 

} 


Tom  gave  the  code  a quick  look  and  a small  smile  creeped  across  his  lips.  I think  Fve 
found  the  problem  Sarah,  and  I bet  I know  by  what  percentage  your  power  usage  readings  are  off 
too! 


What  did  Tom  suspect?  How  could  he  guess  the  power  readings  errors,  and  what  few 
lines  of  code  could  you  add  to  help  debug  this  program? 
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E^fereiae  Solutions 


G.C. 


copyGC  = null; 

No  - this  line  attempts  to  access  a variable 

that  is  out  of  scope. 

gc2  = null; 

OK  - gc2  was  the  only  reference  variable 

referring  to  that  object. 

newGC  = gc3; 

No  - another  out  of  scope  variable. 

gel  = null; 

OK  - gel  had  the  only  reference  because 

new GC  is  out  of  scope. 

newGC  - null; 

No  - new  GC  is  out  of  scope. 

gc4  = null; 

No  - gc3  is  still  referring  to  that  object. 

gc3  = gc2; 

No  - gc4  is  still  referring  to  that  object. 

gel  = gc4; 

OK  - Reassigning  the  only  reference  to 

that  object. 

gc3  = null; 

No  - gc4  is  still  referring  to  that  object. 

p^ujar 

Objects 


It  probably  wasn't  too  hard  to  figure  out  that  the  Honey  object  first  referred  to  by  the  honeyPot  variable  is  by 
far  the  most 'popular' object  In  this  class.  But  maybe  it  was  a little  trickier  to  see  that  all  of  the  variables  that 
point  from  the  code  to  the  Honey  object  refer  to  the  sameobjecti  There  are  a total  of  1 2 active  references  to 
this  object  right  before  the  maln( ) method  completes.  The  fckh  variable  is  valid  for  a while,  but  k gets  nulled 
at  the  end  Since  r.k still  refers  to  the  Kit  object,  rJckh  (although  never  expllaty  declared), refers  to  the  objectl 


public  class  Honey  { 

public  static  void  main (String  []  args)  { 


k » null; 

y > //  end  of  main 
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Flve-jytlnufe  Mystery  S^ufisn 

Tom  noticed  that  the  constructor  for  the  V2Radiator  class  took  an 
ArrayList.  That  meant  that  every  time  the  ViRadiator  constructor  was  called, 
it  passed  an  ArrayList  in  its  super()  call  to  the  V2Radiator  constructor.  That 
meant  that  an  extra  five  V2Radiator  SimUnits  were  created.  If  Tom  was  right, 
total  power  use  would  have  been  120,  not  the  100  that  Sarah’s  expected  ratios 
predicted. 

Since  all  the  Bot  classes  create  SimUnits,  writing  a constructor  for 
the  SimUnit  class,  that  printed  out  a fine  everytime  a SimUnit  was  created, 
would  have  quickly  highlighted  the  problem! 
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Numbers  Matter 


Do  the  Math.  But  there's  more  to  working  with  numbers  than  just  doing  primitive 
arithmetic.  You  might  want  to  get  the  absolute  value  of  a number,  or  round  a number,  or  find 
the  larger  of  two  numbers.  You  might  want  your  numbers  to  print  with  exactly  two  decimal 
places,  or  you  might  want  to  put  commas  into  your  large  numbers  to  make  them  easier  to  read. 
And  what  about  working  with  dates?  You  might  want  to  print  dates  In  a variety  of  ways,  or  even 
manipulate  dates  to  say  things  like/add  three  weeks  to  today's  date"  And  what  about  parsing 
a String  Into  a number?  Or  turning  a number  into  a String?  You're  in  luck. The  Java  API  is  full  of 
handy  number-tweaking  methods  ready  and  easy  to  use.  But  most  of  them  are  static  so  we'll 
start  by  learning  what  it  means  for  a variable  or  method  to  be  static  including  constants  In 
Java— static  final  variables. 
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MATH  methods:  as  close  as  you'll 
ever  get  to  a global  method 

Except  there’s  no  global  anything \n  Java.  But  think  about 
this:  what  if  you  have  a method  whose  behavior  doesn’t 
depend  on  an  instance  variable  value.  Take  the  round  () 
method  in  the  Math  class,  for  example.  It  does  the  same 
thing  every  time — rounds  a floating  point  number(the 
argument  to  the  method)  to  the  nearest  integer.  Every 
time.  If  you  had  10,000  instances  of  class  Math,  and  ran 
the  round(42.2)  method,  you’d  get  an  integer  value  of 
42.  Every  time.  In  other  words,  the  method  acts  on  the 
argument,  but  is  never  affected  by  an  instance  variable 
state.  The  only  value  that  changes  the  way  the  round() 
method  runs  is  the  argument  passed  to  the  method! 

Doesn't  it  seem  like  a ^vaste  of  perfectly  good  heap  space 
to  make  an  instance  of  class  Math  simply  to  run  the 
round()  method?  And  what  about  a/Aer  Math  methods 
like  min(),  which  takes  two  numerical  primitives  and 
returns  the  smaller  of  the  two.  Ormax().  Or  abs(),  which 
returns  the  absolute  value  of  a number. 

These  methods  never  use  instance  variable  values.  In  fact  the 
Math  class  doesn't  have  any  instance  variables.  So  there's 
nothing  to  be  gained  by  making  an  instance  of  class 
Math.  So  guess  what?  You  don't  have  to.  As  a matter  of 
fact,  you  can’L 

If  you  try  to  make  an  instance  of 
class  Math: 

Math  mathOb ject  = new  Math () ; 

You’ll  get  this  error: 


Methods  in  the  Math  class 
don’t  use  any  instance 
variable  values.  And  because 
the  methods  are  ‘static’, 
you  don’t  need  to  have  an 
instance  of  Math.  All  you 
need  is  the  Math  class. 


int  x = Math.round(42 .2)  ; 
int  y = Math. min  (56, 12)  ; 
int  z = Math. abs  (-343); 


. "t'&ods  never 
behav.ov  { need  k 
kn°W  3bou-t  J t obj ttl 


| File  Edit  Window  Help  IwafiTokmiefeWoiitdaeNoMath  I 


%javac  TestMath 

TestMath. java: 3:  Math()  has  private 
access  in  java. lang. Math 

Math  mathObject  = new  Math{); 

A 

1 error 


irr  !k*“  tw  tie  Atatt, 

is  dirked  Private  Tl., 

mm  hit  ^ & » L 

“ il4“  «k»  * ».« m>,  okjtii 
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The  difference  between  regular 
(non-static)  and  static  methods 

Java  is  object-oriented , but  once  in  a while  you  have  a special  case, 
typically  a utility  method  {like  the  Math  methods),  where  there  is 
no  need  to  have  an  instance  of  the  class.  The  keyword  static  lets 
a method  run  without  any  instance  of  the  class.  A static  method  means 
“behavior  not  dependent  on  an  instance  variable,  so  no  instance/object 
is  required.  Just  the  class.*1 


regular  (non-static)  method 

public  class  Song  ( , v3rlabU  vdW 

String  title;  ■"  ^ ot  fV  Y 

public  Song  (String 
title  = t; 

1 

public  void  play()  { 

SoundPlayer  player  = new  SoundPlayer () ; 


) 


Song 


player .playSound (title) ; 


title 


playQ 


T V 


wfchvw  &JL). 


j;  t\^-  ^ 


Song 
s2 . play ( ) ; 


>6 


}y 


Song 

s3 .play  ()  ; 

, / 

Callihg  playO  o*  thji 

+dtrt*U  will  time 
/V)y  IVay"  pby 


static  method 


public  int  min(int  a,  int  b)  { 

//returns  the  leaser  of  a and  b 


1 


U0  -wstarte  vjriaMe*. 

»sU>M  variaW*  stdt£ 


Math. min (42, 36) ; 

'X. 

u*  ^ ciw  **■**  ^ 

tha*  a re-ferc^  v*r,a  e 

name- 


to  Otoecmi 
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static  methods 


Call  a static 
class  name 


Math 

mln() 

maxO 

ab$0 


method 

T 

Hath. min 


using  a 

(88,86) ; 


Call  a non-static  method  using  a 
reference  variable  name 

£3  Song  t2^=^new  Song()  ; 

B | ■•Play()  ; 


What  it  weans  to  have  a 
class  with  static  methods. 


Often  (although  not  always),  a class  with  static 
methods  is  not  meant  to  be  instantiated.  In  Chapter 
8 we  talked  about  abstract  classes,  and  how  marking 
a class  with  the  abstract  modifier  makes  it 
impossible  for  anyone  to  say  'new'  on  that  class  type. 
In  other  words,  iVs  impossible  to  instantiate  an  abstract 
doss . 

But  you  can  restrict  other  code  from  instantiating 
a w?fc-abstract  class  by  marking  the  constructor 
private.  Remember,  a method  marked  private  means 
that  only  code  from  within  the  class  can  invoke 
the  method.  A constructor  marked  private  means 
essentially  the  same  thing — only  code  from  within 
the  class  can  invoke  the  constructor  Nobody  can 
say  'new'  from  outside  the  class.  That's  how  it  works 
with  the  Math  class,  for  example.  The  constructor 
is  private,  you  cannot  make  a new  instance  of  Math. 
The  compiler  knows  that  your  code  doesn't  have 
access  to  that  private  constructor. 


This  does  not  mean  that  a class  with  one  or  more 
static  methods  should  never  be  instantiated.  In  fact, 
every  class  you  put  a main()  method  in  is  a class  with 
a static  method  in  it l 

Typically,  you  make  a main()  method  so  that  you 
can  launch  or  test  another  class,  nearly  always  by 
instantiating  a class  in  main,  and  then  invoking  a 
method  on  that  new  instance. 

So  you're  free  to  combine  static  and  non-static 
methods  in  a class,  although  even  a single  non-static 
method  means  there  must  be  same  way  to  make  an 
instance  of  the  class.  The  only  ways  to  get  a new 
object  are  through  'new'  or  deserialization  (or 
something  called  the  Java  Reflection  API  that  we 
don't  go  into).  No  other  way.  But  exactly  who  says  new 
can  be  an  interesting  question,  and  one  we'll  look  at 
a little  later  in  this  chapter. 
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Static  methods  can't  use  non-static 
(instance)  variables! 


Static  methods  mn  without  knowing  about  any  particular 
instance  of  the  static  method's  class.  And  as  you  saw  on 
the  previous  pages,  there  might  not  even  ^any  instances 
of  that  class.  Since  a static  method  is  called  using  the  class 
(7lfatfi.random())  as  opposed  to  an  instance  reference  (t2p]ay()), 
a static  method  can't  refer  to  any  instance  variables  of  the 
class.  The  static  method  doesn't  know  which  instance *s  variable 
value  to  use. 


If  you  tty  to  use  an 
instance  variable  from 
inside  a static  method, 
the  compiler  -dunks, 

“I  don't  know  which 


If  you  try  to  compile  this  code: 

public  0I&8S  Duck  ( 
private  int  size; 


public  static  void  main  (String []  axgs)  { 

System. out. println ("Size  of  duck  is  " + size) 


) 

public  void  aetSize(int  s) 
size  = s; 


7'^  *omcwh« 


object's  instance  variable 
you’re  talking  about!” 

If  you  have  ten  Duck 
objects  on  the  heap,  a 
Static  method  doesn’t 
know  about  any  of  diem. 


) 

public  int  getSize()  { 
return  size ; 

> 


You’ll  get  this  error: 


fm  Edti  Window  Help  Quad; 


% javac  Duck. java 

Duck, java: 6:  non-static  variable 
size  cannot  be  referenced  from  a 
static  context 

System. out .print In ("Size 
of  duck  is  " + size)  ; 
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Static  methods  can't  use  non-static 
methods,  either! 


What  do  non-static  methods  do?  They  usually  use  instance 
variable  state  to  affect  the  behamor  of  the  method.  A getName  () 
method  returns  the  value  of  the  name  variable.  Whose  name? 
The  object  used  to  invoke  the  getName ()  method. 


This  won’t  compile: 

public  class  Duck  { 
private  int  size; 


lz*  lhlta«cc  variable 


public  static  void  main  (String[]  args)  { 

Syatanwout  .println  ("Size  is  " + getSizeO); 

) 

public  void  satSiza(int  s)  { 
size  = s; 

} 

public  int  getSize()  l 
return  size; 


'folk  ka  W*  r 


Into  Edit  WlfxJow  Help  Jack-In 


% javac  Duck. java 

Duck. java: 6:  non-static  method 
getSize()  cannot  be  referenced 
from  a static  context 

System . out , println ( "Size 
of  duck  is  " + getSizef)) 


Make  * 


Boses  are  red, 

Status  can't  see 


Dujn{?^iesf5pT]s 


Q?  What  If  you  try  to  call  a non-static 
method  from  a static  method,  but  the 
non-static  method  doesn't  use  any  in- 
stance variables.  Will  the  compiler  allow 
that? 


A. 

'rL-  No. The  compiler  knows  that 
whether  you  do  or  do  not  use  instance 
variables  In  a non-static  method,  you  can. 
And  think  about  the  implications...  if  you 
were  allowed  to  compile  a scenario  like 
that,  then  what  happens  if  in  the  future 
you  want  to  change  the  implementation 
of  that  non-static  method  so  that  one  day 
it  does  use  an  instance  variable?  Or  worse, 
what  happens  if  a subclass  overrides  the 
method  and  uses  an  instance  variable  In 
the  overriding  version? 

Q/  I could  swear  I've  seen  code  that 
calls  a static  method  using  a reference 
variable  Instead  of  the  class  name. 


You  can  do  that,  but  as  your  mother 
always  told  you/Just  because  it's  legal 
doesn't  mean  it's  good. "Although  It  works 
to  call  a static  method  using  any  instance 
of  the  class,  it  makes  for  misleading  (less- 
readable)  code.  You  can  say, 

Duck  d = new  Duck()  ; 

String []  s = { ) ; 
d. main (ft) ; 


This  code  is  legal,  but  the  compiler  just 
resolves  It  back  to  the  real  class  anyway 
("OK,  dls  of  type  Duck,  and  malnO  Is  static, 
so  I'll  call  the  static  malnO  in  class  Duck"). 
In  other  words,  using  d to  invoke  main() 
doesn't  imply  that  maln()  will  have  any 
special  knowledge  of  the  object  that  d Is 
referencing.  It's  just  an  alternate  way  to 
Invoke  a static  method,  but  the  method  Is 
still  static! 
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Static  variable: 

value  is  the  same  for  ALL 
instances  of  the  class 


Imagine  you  wanted  to  count  how  many  Duck 
instances  are  being  created  while  your  program  is 
running.  How  would  you  do  it?  Maybe  an  instance 
variable  that  you  increment  in  the  constructor? 


class  Duck  { 

int  duck Count  = 0; 
public  Duck  ()  { 

duckCount++ ; 


} 


) 


■Ssaz?* 

' ^ W.  b 


No,  that  wouldn't  work  because  duckCount  is  an 
instance  variable,  and  starts  at  0 for  each  Duck.  You 
could  try  calling  a method  in  some  other  class,  but 
that's  kludgey.  You  need  a class  that's  got  only  a single 
copy  of  the  variable,  and  all  instances  share  that  one 
copy. 


private  int  size;  ^ 

private  int  duckCount  * 0; 


public  class  Duck  { 


* *,7/  ^ 


public  Duck ( ) ( 

ducJtCeunt++ ; <— 

1 a.  SSfes?  *** 

public  void  setSize(int  s)  { 
size  = s; 

1 

public  int  getSize ()  { 
return  size; 

) 


That's  what  a static  variable  gives  you:  a value  shared 
by  all  instances  of  a class.  In  other  words,  one  value 
per  class,  instead  of  one  value  per  instance. 


fat)* 


iYtet 


kb*1* 


£ ^O*'  {****'"’• 

a a wa**3™4;  ,l 


fylLX** 

a\\ 


Duck  | 

size 

^tatlcduckC 

ountf 

V 

1 getSlzeO 
setSizeO 

L 

of  5 


6°CI<  oW* 


/ size:  8 V 
(duchCoart:/ 

yJ^TiaV 

X J. 

nuckCount;  * 

^ckdof 


^rctefc*^ 


Due I j.-  , 

***  v*-«We,  £ <>w» 

«opy  < only 

v^iab^^^^kCounf:  7 


you  are  here  ► 279 


static  variables 


Static  variables  are  sbarecL 

All  instances  of  the  same 
class  share  a single  copy  of 
the  static  variables. 


instance  variables:  1 per  instance 
static  variables:  1 per  class 


Brain  Barbell 


Earlier  in  this  chapter,  we  saw  that  a private 
constructor  means  that  the  class  can't  be  instantiated 
from  code  running  outside  the  class.  In  other  words, 
only  code  from  within  the  class  can  make  a new 
instance  of  a class  with  a private  constructor.  (There's 
a kind  of  chlcken-and-egg  problem  here.) 


What  If  you  want  to  write  a class  in  such  a way  that 
only  ONE  instance  of  it  can  be  created,  and  anyone 
who  wants  to  use  an  instance  of  the  class  will  always 
use  that  one, single  Instance? 
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Static  variables  are  initialized  when  a class  is  loaded.  A class  is 
loaded  because  the  JVM  decides  it’s  time  to  load  it.  Typically, 
the  JVM  loads  a class  because  somebody's  trying  to  make  a 
new  instance  of  the  class,  for  the  first  time,  or  use  a static 
method  or  variable  of  the  class.  As  a programmer,  you  also 
have  the  option  of  telling  the  JVM  to  load  a class,  but  youTe 
not  likely  to  need  to  do  that.  In  nearly  all  cases,  you're  better 
off  letting  the  JVM  decide  when  to  load  the  class. 

And  there  are  two  guarantees  about  static  initialization: 

Static  variables  in  a class  are  initialized  before  any  object  of  that 
class  can  be  created. 


All  static  variables 
in  a class  are 
initialized  before 
any  object  of 
that  class  can  be 
created. 


Static  variables  in  a class  are  initialized  before  any  static  method 
of  the  class  runs. 


class  Player  { 

static  int  playerCount  = 0; 
private  String  name; 
public  Player (String  n)  { 


ne  plavevCo^i  i*  ^ ^ 

ic  smde  0 is  the  default  value  »**■  J 

*!«,  yt  drfa.lt 


name  = n; 
playerCount++ ; 

) 

) 

public  class  PlayerTastDrive  ( 

public  static  void  main (String (]  args)  { 

System. out .println (Player .playerCount) ; 
Player  one  = new  Player ("Tiger  Woods " ) ; 


booleaR.' 

objeit  trefeirftid**:  nu|| 


System. out. println  (Player  .playerCount)  ; 

} \ f\Ltta  a variable  jwt  ^ * statit 

} wetW-with  the  tlass  id**- 


Static  variables  are  initialized  when  the  class  is  loaded.  If  you 
don’t  explicitly  initialize  a static  variable  (by  assigning  it  a 
value  at  the  time  you  declare  it),  it  gets  a default  value,  so  int 
variables  are  initialized  to  zero,  which  means  we  didn't  need 
to  explicitly  say  “playerCount  = 0”.  Declaring,  but  not  initial- 
izing, a static  variable  means  the  static  variable  will  get  the  de- 
fault value  for  that  variable  type,  in  exactly  the  same  way  that 
instance  variables  are  given  default  values  when  declared. 


I File  Edit  Wrndow  Help  Whal? 


% java  PiayerTes tDrive 

® ^ before  dhv  ir.ri:anf.C'  an? 


3r'  is  f.reiied 


you  are  here  > 281 


static  final  constants 


static  final  variables  are  constants 


A variable  marked  final  me  am  that — once  initialized — it  can 
never  change.  In  other  words,  the  value  of  the  static  final  variable 
will  stay  the  same  as  long  as  the  class  is  loaded.  Look  up  Math.Pl 
in  the  API,  and  you’11  find: 

public  static  final  double  PI  = 3.141592653589793; 

The  variable  is  marked  public  so  that  any  code  cao  access  it. 

The  variable  is  marked  static  so  that  you  don't  need  an 
instance  of  class  Math  (which,  remember,  you're  not  allowed  to 
create) . 

The  variable  is  marked  final  because  PI  doesn’t  change  (as  far  as 
Java  is  concerned). 

There  is  no  other  way  to  designate  a variable  as  a constant,  but 
there  is  a naming  convention  that  helps  you  to  recognize  one. 
Constant  variable  names  should  be  in  aH  caps! 


static  initializer 


Initialize  a final  static  variable: 


OR 


At  the  time  you  declare  it: 

public  class  Foo  { 

public  static  final  int  FOO_X  = 25; 

4.3  *’"*W*, 


If  you  don't  give  a value  to  o final  variable 
in  one  of  those  two  places: 

public  class  Bar  { 

public  static  final  double  RAR_SIGN; 

The  compiler  will  catch  It: 


In  o static  Initializer: 

public  al&ee  Bar  { 

public  static  final  double  BARSIGN ; 


■i  { 

BAH_SIGN  - (double) 


. 

is  loaded  h+£  * ik*  Ai 

ix  tali  7 1 ***<»*  <shV  u i 


I File  Edit  Window  Help  Jack-in  | 


% javac  Bar, java 

Bar . java : 1 : variable  BAR_SIGN 
might  not  have  been  initialized 

1 error 
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You  can  use  the  keyword  final  to  modify  non- 
static variables  too,  including  instance  variables, 
local  variables,  and  even  method  parameters.  In 
each  case,  it  means  the  same  thing:  the  value  can't 
be  changed.  But  you  can  also  use  final  to  stop 
someone  from  overriding  a method  or  making  a 
subclass. 


non-static  final  variables 


class  Foof  { 

„ n , * A tvOW 

final  Int  size  = 3;< 
final  int  whuffie ; 


you 


Uni 


Foo£()  I ,,  L £C- 

whuffia  = A2;  <*—  no'u  70U  ta«\x  \wbur-ne 

) 

void  doStuff (final  int  x)  ( 

//  you  can't  change  x 

} 


A final  variable  means  you 
can’t  change  its  value. 

A final  method  means  you 
can’t  override  the  method. 

A final  class  means  you 
can’t  extend  the  class  (i.e. 
you  can’t  make  a subclass). 


void  doMore()  { 
final  int  z = 7; 

//  you  can't  change  z 

} 

) 


final  method 

class  Poof  { 

final  void  calcWhuffie  ()  { 

II  important  things 
U that  must  never  be  overridden 

) 

> 


final  class 

final  class  MyMostFerfectClass  { 
//  cannot  be  extended 

> 
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cfefl^t^uegtforis 


Q,*  A static  method  can't  access  a 
non-static  variable.  But  can  a non-static 
method  access  a static  variable? 


A- 

Ml*  Of  course.  A non-static  method  in  a 
class  can  always  call  a static  method  in  the 
class  or  access  a static  variable  of  the  class. 


Why  would  I want  to  make  a class 
final?  Doesn't  that  defeat  the  whole 
purpose  of  OO? 

A. 

Ves  and  no.  A typical  reason  for 
making  a class  final  Is  for  security.  You 
can't,  for  example,  make  a subclass  of  the 
String  class.  Imagine  the  havoc  If  someone 
extended  the  String  class  and  substituted 
their  own  String  subclass  objects, 
polymorphlcally,  where  String  objects 
are  expected.  If  you  need  to  count  on  a 
particular  Implementation  of  the  methods 
In  a class,  make  the  class  final. 


Isn't  it  redundant  to  have  to  mark 
the  methods  final  If  the  class  Is  final? 


A. 

r\-  If  the  class  Is  final,  you  don't  need  to 
mark  the  methods  final.Think  about  It — if 
a class  Is  final  It  can  never  be  subclassed, 
so  none  of  the  methods  can  ever  be 
overridden. 

On  the  other  hand.  If  you  do  want  to  allow 
others  to  extend  your  class,  and  you  want 
them  to  be  able  to  override  some,  but  not 
all,  of  the  methods,  then  don't  mark  the 
class  final  but  go  in  and  selectively  mark 
specific  methods  as  final.  A final  method 
means  that  a subclass  can't  override  that 
particular  method. 


BULLET  POIMTS^^ 

■ A static  method  should  be  called  using  the  class 
name  rather  than  an  object  reference  variable: 

Math . random  ( ) vs.  myFoo . go  ( ) 

■ A static  method  can  be  invoked  without  any  Instances 
of  the  method’s  class  on  the  heap. 

■ A static  method  is  good  for  a utility  method  that  does 
not  (and  will  never)  depend  on  a particular  Instance 
variable  value. 

■ A static  method  is  not  associated  with  a particular 
instance— only  the  class— so  It  cannot  access  any 
instance  variable  values  of  its  class.  It  wouldn't  know 
which  Instance's  values  to  use. 

■ A static  method  cannot  access  a non-static  method, 
since  non-static  methods  are  usually  associated  with 
instance  variable  state. 

■ If  you  have  a class  with  only  static  methods,  and  you 
do  not  want  the  dass  to  be  instantiated,  you  can  mark 
the  constructor  private. 

■ A static  variable  is  a variable  shared  by  all  members 
of  a given  dass.  There  is  only  one  copy  of  a static 
variable  in  a class,  rather  than  one  copy  per  each 
individual  instance  for  instance  variables. 

■ A static  method  can  access  a static  variable. 

■ To  make  a constant  in  Java,  mark  a variable  as  both 
static  and  final. 

■ A final  static  variable  must  be  assigned  a value  either 
at  the  time  it  is  dedared,  or  in  a static  initializer, 
static  ( 

DOG_CODE  = 420; 

} 

■ The  naming  convention  for  constants  (final  static 
variables)  is  to  make  the  name  all  uppercase. 

■ A final  variable  value  cannot  be  changed  once  It  has 
been  assigned. 

■ Assigning  a value  to  a final  Instance  variable  must  be 
either  at  the  time  it  Is  declared,  or  in  the  constructor. 

■ A final  method  cannot  be  overridden. 

■ A final  dass  cannot  be  extended  (subdassed). 
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parpen  your  pencil 

What’s  Legal? 

Given  everything  you've  just 
learned  about  static  and  final, 
which  of  these  would  compile? 


KEEP 

RIGHT 


public  class  Foo  { 
static  int  x; 


public  void  go()  { 

System. out. println(x)  ; 

) 


public  class  Foo2  { 
int  x; 


public  static  void  go()  { 
System,  out  .printin  (x)  ; 

} 


public  class  Foo4  { 

static  final  int  x = 12; 


public  void  go()  { 

System. out. println(x)  ; 

) 


public  class  Foo5  { 

static  final  int  x = 12; 


public  void  go (final  int  x)  { 
System. out  .println  (x)  ; 

} 


public  class  Foo3  { 
final  int  x; 


public  void  go()  { 

System. out. println(x) ; 

) 


public  class  F006  ( 

W int  x = 12; 

public  static  void  go  (final  int  x)  ( 
System. out. println(x)  ; 
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Math  methods 

Now  that  we  know  how  static 
methods  work,  let’s  look 
at  some  static  methods  in 
class  Math.  This  isn’t  all  of 
them,  just  the  highlights. 
Check  your  API  for  the  rest 
including  sqrt(),  tan(),  ceil(), 
floor (),  and  asin(). 


Math.random() 

Returns  a double  between  0.0  through  (but 

not  including)  1.0. 

double  rl  = Math . random  ( ) ; 

int  r2  = (int)  (Math . random ( ) * 5) ; 


Math.abs() 

Returns  a double  that  is  the  absolute  value  of 
the  argument.  The  method  is  overloaded,  so 
if  you  pass  it  an  int  it  returns  an  int.  Pass  it  a 
double  it  returns  a double. 


int  x = Math. abs (-240) ; //  returns  240 

double  d = Math. abs (240 .45) ; //  returns  240.45 


Math.round() 

Returns  an  int  or  a long  (depending  on 
whether  the  argument  is  a float  or  a double) 
rounded  to  the  nearest  integer  value. 


int  x = Math. round (-24 . 8f) ; //  returns  -25 

int  y = Math. round (24. 45f ) ; //  returns  24 


Math.min() 


r^T  L,  litorals  arc 

to  be  doubles  unless  you  add  the 


Returns  a value  that  is  the  minimum  of  the 


two  arguments.  The  method  is  overloaded  to 

take  ints,  longs,  floats,  or  doubles. 

int  x = Math. min (24, 240) ; //  returns  24 

double  y = Math. min (90876. 5,  90876.49);  //  returns  90876.49 


Math.max() 

Returns  a value  that  is  the  maximum  of  the 
two  arguments.  The  method  is  overloaded  to 
take  ints,  longs,  floats,  or  doubles, 
int  x = Hath. max(24, 240) ; //  returns  240 

double  y = Math. max (90876. 5,  90876.49);  //  returns  90876.5 
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Wrapping  a primitive 

Sometimes  you  want  to  treat  a primitive  like 
an  object  For  example,  in  all  versions  of  Java 
prior  to  5.0,  you  cannot  put  a primitive  directly 
into  a collection  like  ArrayList  or  HashMap: 

int  x = 32; 

ArrayList  list  = new  Arrayl*ist()  ; 
list,  add  (x) 

work 
Wi 

3n  in 

■that  -take  objed 

There’s  a wrapper  class  for  every  primitive  type, 
and  since  the  wrapper  classes  are  in  the  java, 
tang  package,  you  don't  need  to  import  them. 
You  can  recognize  wrapper  classes  because 
each  one  is  named  after  the  primitive  type  it 
wraps,  but  with  the  first  letter  capitalized  to 
follow  the  class  naming  convention. 

Oh  yeah,  for  reasons  absolutely  nobody  on  the 
planet  is  certain  of,  the  API  designers  decided 
not  to  map  the  names  exactly  from  primitive 
type  to  class  type.  You'll  see  what  we  mean: 


This  won't 


nless  yo*\re  wan*  Java  5.0  or 
no  aJdtinO  -eth od  in  A^ayUt 
/ (AyY^yLiit  onW  has  addO  methods 

r _ * „ -i.  DwtMit 


Boolean 
Character 
Byte 
Short 
Integer 
Long 
Float 
Double 

wrapping  a value 

int  i = 288; 


MdbtM  out)  Tbe  t 

tUtty  to 

tyfcs.  Tbe  dais  art  Wily 
s^elltd  out- 


fyvt  tb<  bo  ^ 

wrayyer  (UmsirutW-  Thats  it- 


/ 

(i); 


J.IU.  -L.  4.00  f 

Integer  iWrap  = new  Integer 

All  tb«  'work 

. like  this.  Soolti*1  bas  a 

, . / boolcarValutO,  Cbaratbtv 

unwrapping  a value  ^ a ^avVaW),  dt. 

int  unwrapped  = iWrap . intValue  ( ) ; 


primitive 


Wt,en  you  need  to  treat 
a primitive  like  an  object, 
wrap  it.  If  you’re  using  any 
version  of  Java  before  5.0, 
you’ll  do  this  when  you 
need  to  store  a primitive 
value  inside  a collection  like 
ArrayList  or  HashMap. 


Note:  the  picture  at  the  top  is  a chocolate  in  a foil  wrapper.  Get 
It?  Wrapper?  Some  people  think  it  looks  like  a baked  potato,  but 
that  works  too. 
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. / This  is  stupid.  You  mean  I can't 
just  make  an  ArrayUst  of  ints???  I 
have  to  wrap  every  single  trickin'  one  in  a new 
Integer  object,  then  unwrap  it  when  I try 
to  access  that  value  in  the  ArrayUst? 

That1  s a waste  of  time  and  an  error  . 
. Ox.  waiting  to  happen... 


Before  Java  5.0,  YOU  had  to  do  the  work... 

She's  right  In  all  versions  of  Java  prior  to  5,0,  primitives  were  primitives 
and  object  references  were  object  references,  and  they  were  NEVER 
treated  interchangeably.  It  was  always  up  to  you,  the  programmer,  to  do 
the  wrapping  and  unwrapping.  There  was  no  way  to  pass  a primitive  to  a 
method  expecting  an  object  reference,  and  no  way  to  assign  the  result  of  a 
method  reluming  an  object  reference  directly  to  a primitive  variable — even 
when  the  returned  reference  is  to  an  Integer  and  the  primitive  variable  is 
an  int  There  was  simply  no  relationship  between  an  Integer  and  an  int, 
other  than  the  fact  that  Integer  has  an  instance  variable  of  type  int  (to  hold 
the  primitive  the  Integer  wraps).  All  the  work  was  up  to  you. 


An  ArrayUst  of  primitive  ints 


Without  autoboxing  (Java  versions  before  5.0) 


public  void  doNumsOldWay ()  { 


ns  Devore  o.m  u l 


Array  List  liatOfNiimbers  = new  ArrayLiat();  , t 

, 'l  M ** 

listOfNumbers.add(new  Integer  (3))  ; ^ — t°u  l ^30  m ** 

$0  xp  \ 


Integer  one  = (Integer)  listOfKumbers  ,get  (0)  ; out  as  ty?* 

owci  wtr* 

int  intOne  - one . intValue ()  ; Object  to  an 
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Autoboxing:  blurring  the  line 
between  primitive  and  object 

The  autoboxing  feature  added  to  Java  5.0  does 
the  conversion  from  primitive  to  wrapper  object 
automatically! 

Let’s  see  what  happens  when  we  want  to  make  an 
ArrayList  to  hold  ints. 


An  ArrayList  of  primitive  ints 


With  autoboxing  (Java  versions  5.0  or  greater) 


public  void  doNumsNewWay ( ) 


Aflat,  a. 

X 


ArrayList<Integer>  listOfNumbers  = new  ArrayList<Integer> ( ) ; 


list0fNumbers.add(3)  ; Jus-fc  add  rfc/ 

int  num  = listOfNumbers . get  (0)  ; 

v 

thl 


Although  there  is  HOT  a method  in  ArrayLisb 
•for  add(int),  the  Compiler  does  alt  the  u^rapfing 
(homing)  -for  you.  |n  other  words,  there  really  [S 
an  Integer  object  stored  m the  AvrayList>  but 
you  get  to  "pretend*  that  the  ArrayList  takes 
ints*  (You  dan  add  both  ints  and  Integers  to  an 
ArrayList<fnteger>.) 


Q*  Why 
hold  ints? 


not  declare  an  ArrayLi$t<int>  if  you  want  to 


A- 

Jr\ • Because... you  can't  Remember,  the  rule  for  generic 
types  is  that  you  can  specify  only  class  or  interface  types,  not 
primitives.  So  ArrayList<int>  will  not  compile.  But  as  you  can 
see  from  the  code  above,  it  doesn't  really  matter,  since  the 
compiler  lets  you  put  ints  into  the  ArrayList<Integer>.  In  fact, 
there's  really  no  way  to  prevent  you  from  putting  primitives 
into  an  ArrayList  where  the  type  of  the  list  is  the  type  of  that 
primitive's  wrapper,  if  you're  using  a Java  5.0-compliant  com- 
piler, since  autoboxing  will  happen  automatically.  So,  you  can 
put  boolean  primitives  in  an  ArrayList<Boolean>  and  chars 
into  an  ArrayListcCharacterx 
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Autoboxing  works  almost  everywhere 

Autoboxing  lets  you  do  more  than  just  the  obvious  wrapping  and 
unwrapping  to  me  primitives  in  a collection...  it  also  lets  you  use 
either  a primitive  or  its  wrapper  type  virtually  anywhere  one  or  the 
other  is  expected*  Think  about  that! 


Fun  with  autoboxing 


Method  arguments 

If  a method  fakes  a wrapper  type,  you 
can  pass  a reference  to  a wrapper  or 
a primitive  of  the  matching  type.  And 
of  course  the  reverse  is  true— if  a 
method  takes  a primitive,  you  can 
pass  in  either  a compatible  primitive 
or  a reference  to  a wrapper  of  that 
primitive  type. 


void  takeNumber  (Integer  i)  { } 


Return  values 

If  a method  declares  a primitive 
return  type,  you  can  return  either  a 
compatible  primitive  or  a reference 
to  the  wrapper  of  that  primitive  type 
And  if  a method  declares  a wrapper 
return  type,  you  can  return  either  a 
reference  to  the  wrapper  type  or  a 
primitive  of  the  matching  type. 


int  giveNumber ( ) { 
return  x; 


Boolean  expressions 

Any  place  a boolean  value  is  expected, 
you  can  use  either  an  expression  that 
evaluates  to  a boolean  (4  > 2),  or  a 
primitive  boolean,  or  a reference  to  a 
Boolean  wrapper 


System. out .pr in tin ("true") ; 

) 
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Operations  on  numbers 

This  is  probably  the  strangest  one— yes,  you 
can  now  use  a wrapper  type  as  an  operand 
in  operations  where  the  primitive  type  is 
expected.  That  means  you  can  appfy,  say, 
the  increment  operator  against  a reference 
to  an  Integer  object) 

But  don't  worry— this  is  just  a compiler  trick. 
The  language  wasn't  modified  to  make  the 
operators  work  on  objects;  the  compiler 
simply  converts  the  object  to  its  primitive 
type  before  the  operation.  It  sure  looks 
weird,  though. 

Integer  i - new  Integer(42); 
i++; 


v~ 


i++; 


And  that  means  you  can  also  do  things  like: 

Integer  j = new  Integer(5); 

Integer  k = j +■  3; 


Assignments 

You  can  assign  either  a wrapper  or  primitive 
to  a variable  declared  as  a matching  wrapper 
or  primitive.  For  example,  a primitive  int 
variable  can  be  assigned  to  an  Integer 
reference  variable,  and  vice-versa— a 
reference  to  an  Integer  object  can  be 
assigned  to  a variable  declared  as  an  int 
primitive. 


4^tirpen  your  pencil 


Will  this  code  compile?  Will  It  run?  If  It  runs, 
what  will  It  do? 

Take  your  time  and  think  about  this  one;  it 
brings  up  an  implication  of  autoboxing  that 
we  didn't  talk  about. 


public  class  TastBox  { 

Intagar  1; 

Int  j; 

public  static  void  main  (String!]  args)  ( 
TastBox  t = naw  TastBox ()  ; 
t.go() ; 

) 


You'll  have  to  go  to  your  compiler  to  find 
the  answers.  (Yes,  we're  forcing  you  to 
experiment,  for  your  own  good  of  course.) 


public  void  go()  { 
j-i; 

Syatam. out .print In ( j) ; 
Syfltam.out.println(i) ; 
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Put  wait!  there's  more!  Wrappers 
have  static  utility  methods  too! 

Besides  acting  like  a normal  class,  the  wrappers  have  a 
bunch  of  really  useful  static  methods.  We've  used  one  in 
this  book  before — Integer. parselnt(). 

The  parse  methods  take  a String  and  give  you  back  a 
primitive  value. 

Converting  a String  to  a ^ U 
primitive  value  Is  easy:  m-to  2- 

String  s = "2"; 

int  x = Integer  . parselnt (s)  ; 

double  d = Double. parsaDouble ("420 . 24") ; 


boolean  b = new  Boolean (" true") .booleanValue ( ) ; 


But  if  you  try  to  do  this: 

String  t = "two"; 

int  y = Integer .parselnt (t) 


Uk-ok.  Compiles  just,  but 

Vc.  at  runtime  it  blows  up.  Anything 
; tkat  can't  be  parked  as  a number 

will  cause  a Kumbev-FormatExcepton 


You’ll  get  a runtime  exception: 


I Fite  Edil  Window  Help  plus  | 


% java  Wrappers 

Exception  in  thread  "main" 

java . lang . NumberFormatException : two 

at  java . lang . Integer . parselnt (Integer . java : 409) 

at  java , lang . Integer .parselnt (Integer , java : 458) 

at  Wrappers . main (Wrappers . java : 9) 


Every  method  or 
constructor  that  parses 
a String  can  throw  a 
NumberFormatException. 
It’s  a runtime  exception, 
so  you  don’t  have  to 
handle  or  declare  It. 

But  you  might  want  to. 

(We'll  talk  about  Exceptions  in  the 
next  chapter.) 
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And  how  in  reverse...  turning  a 
primitive  number  into  a String 


There  are  several  ways  to  turn  a number  into  a String. 

The  easiest  is  to  simply  concatenate  the  number  to  an 

e,di,i"S  lU-*-  '?  ‘ 

d ‘ 42  5'  ^ ‘ 
String  doubleString  = ""  + d;  ^ 


double  d = 42.5; 

String  doublestring  = Double > toString (d) ; 


V potter  way  h>do  a win3  a ^ 

method  Jh  t\A$i  Double.  D 
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Number  formatting 

In  Java,  formatting  numbers  and  dates  doesn't  have  to  be  coupled  with  I/O.  Think 
about  it.  One  of  the  most  typical  ways  to  display  numbers  to  a user  is  through  a 
GUI.  You  put  Strings  into  a scrolling  text  area,  or  maybe  a table.  If  formatting  was 
built  only  into  print  statements,  you'd  never  be  able  to  format  a number  into  a nice 
String  to  display  in  a GUI.  Before  Java  5.0,  most  formatting  was  handled  through 
classes  in  the  java.text  package  that  we  won't  even  look  at  in  this  version  of  the 
book,  now  that  things  have  changed. 

In  Java  5.0,  the  Java  team  added  more  powerful  and  flexible  formatting  through  a 
Formatter  class  injava.util.  But  you  don't  need  to  create  and  call  methods  on  the 
Formatter  class  yourself,  because  Java  5.0  added  convenience  methods  to  some  of 
the  I/O  classes  (including  printf())  and  the  String  class.  So  it's  a simple  matter  of 
calling  a static  String.format()  method  and  passing  it  the  thing  you  want  formatted 
along  with  formatting  instructions. 

Of  course,  you  do  have  to  know  how  to  supply  the  formatting  instructions,  and 
that  takes  a little  effort  unless  you're  familiar  with  the  printf()  function  in  C/C++. 
Fortunately,  even  if  you  don't  know  printf()  you  can  simply  follow  recipes  for  the 
most  basic  things  (that  we're  showing  in  this  chapter) . But  you  will  want  to  learn 
how  to  format  if  you  want  to  mix  and  match  to  get  any  thing  you  want. 

We’ll  start  here  with  a basic  example,  then  look  at  how  it  works.  (Note:  we'll  revisit 
formatting  again  in  the  I/O  chapter.) 


Formatting  a number  to  use  commas 

public  class  TestFormats  { 

public  static  void  main  (String []  args)  { 


c 


TV*  number  to  Wat 

*a*t '.t  to  Have  togas' 


String  s = String. format ("%,  d",  1000000000); 

System. out  .println  (s)  ; ^ ^ - — * 

\ 

*Wo*d  a^Se«V?ittn^^KoW  *<***&■  the 

W*be,;  the,e  arecnll  + ^ value), 

•wve-the  -first  Com,*,  h 


1,000,000,000 


M 


ow 


^5+ Commas  i^rted  into  the 


number. 
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Formatting  deconstructed... 

At  the  most  basic  level,  formatting  consists  of  two  main  parts 
(there  is  more,  but  we’ll  start  with  this  to  keep  it  cleaner): 


^ Formatting  Instructions 

You  use  special  format  specifiers  that  describe  how 
the  argument  should  be  formatted. 


^ The  argument  to  be  formatted. 

Although  there  can  be  more  than  one  argument,  we'll 
start  with  just  one.  The  argument  type  can’t  be  just 
anything...  it  has  to  be  something  that  can  be  formatted 
using  the  format  specifiers  in  the  formatting  instructions. 
For  example,  if  your  formatting  instructions  specify  a 
floating  point  number,  you  can’t  pass  in  a Dog  or  even  a 
String  that  looks  like  a floating  point  number. 


po  tW*' 


this. 


format ("%,  d",  1000000000); 

T T 

Use  these  instructions...  on  this  argument. 


t/ur IV nWS  Othevwse, 


vor»  1 ’ * 

vcad  ureWty! 


What  do  these  instructions  actually  say? 

“Take  the  second  argument  to  this  method,  and 
format  it  as  a decimal  integer  and  insert  commas/' 

How  do  they  say  that? 

On  the  next  page  we’ll  look  in  more  detail  at  what  the  syntax  “%, 
d”  actually  means,  but  for  starters,  any  time  you  see  the  percent 
sign  (%)  in  a format  String  (which  is  always  the  first  argument 
to  a formatQ  method),  think  of  it  as  representing  a variable, 
and  the  variable  is  the  other  argument  to  the  method.  The  rest 
of  the  characters  after  the  percent  sign  describe  the  formatting 
instructions  for  the  argument. 
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The  percent  K)  says,  "insert  argument  here" 

(and  format  It  using  these  instructions) 


The  first  argument  to  a format()  method  is  called  the  format  String,  and  it 
can  actually  include  characters  that  you  just  want  printed  as-is,  without  extra 
Formatting.  When  you  see  the  % sign,  though,  think  of  the  percent  sign  as  a 
variable  that  represents  die  other  argument  to  the  method. 


CVdv-atto-1 lrilu^e  k ihe  i'Lo*d  * r 


*&rr*J'bLtd' 


fonnat("I  have  %.2f  bugs  to  fix 


476578 .09876) ; 


I have  4*76578.10  bugs  to  fix. 


th‘  meins? 


The  sign  tells  the  formatter  to  insert  the  other  method  argument  (die 
second  argument  to  formatO,  die  number)  here,  AND  format  it  using  die 
“.2 r characters  after  the  percent  sign.  Then  the  rest  of  the  format  String, 
“bugs  to  fix”,  is  added  to  the  final  output. 


Adding  a comma 

format  (v> I have  %,.2f  bugs  to  fix.",  476578.09876}; 


I have  476,578.10  bugs  to  fix. 


Bv  tKe  format 

n,h-Vta 


torrid  ih 


ic  -forwUed  *iW»bev- 
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But  how  does  it  even  KNOW 
where  the  instructions  end  and  the 
rest  of  the  characters  begin?  How  come 
it  doesn't  print  out  the  “f " in  *%.2f*?  Or 
the  *2U?  How  does  it  know  that  the  >2f 
was  part  of  the  instructions  ond  NOT^ 
part  of  the  String? 


The  format  String  uses  its 
own  little  language  syntax 

You  obviously  can't  put  just  anything  after  the  “%" 
sign.  The  syntax  for  what  goes  after  the  percent 
sign  follows  very  specific  rules*  and  describes 
how  to  formal  the  argument  that  gets  inserted  at 
that  point  in  the  result  (formatted)  String. 

You've  already  seen  two  examples: 

%,  d means  “insert  commas  and  format  the 
number  as  a decimal  integer." 

and 


%.2f  means  “format  the  number  as  a floating 
point  with  a precision  of  two  decimal  places." 

and 


%,.2f  means  “insert  commas  and  format  the 
number  as  a floating  point  with  a precision  of 
two  decimal  places." 

The  real  question  is  really  “How  do  I know  what 
to  put  after  the  percent  sign  to  get  it  to  do  what 
I want?"  And  that  includes  knowing  the  symbols 
(like  ud"  for  decimal  and  ttF  for  floating  point) 
as  well  as  the  order  in  which  the  instructions 
must  be  placed  following  the  percent  sign.  For 
example*  if  you  put  the  comma  after  the  ud”  like 
this:  “%d>"  instead  of  u%,d"  it  won't  work! 

Or  will  it?  What  do  you  think  tins  will  do: 


String. format ("I  have  %.2f,  bugs  to  fix.",  476578.09676); 
(We'll  answer  that  on  the  next  page.) 
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The  format  specifier 

Everything  after  the  percent  sign  up  to  and  including  the  type  indicator  (like 
“d”  or  “F)  are  part  of  the  formatting  instructions.  After  the  type  indicator,  the 
formatter  assumes  the  next  set  of  characters  are  meant  to  be  pan  of  the  output 
String,  until  or  unless  it  hits  another  percent  (%)  sign.  Hmmmm...  is  that  even 
possible?  Can  you  have  more  than  one  formatted  argument  variable?  Put  that 
thought  on  hold  for  right  now;  we'll  come  back  to  it  in  a few  minutes.  For  now, 
let's  look  at  the  syntax  for  the  format  specifiers — the  things  that  go  after  the 
percent  (%)  sign  and  describe  how  the  argument  should  be  formatted. 

A format  specifier  can  have  up  to  five  different  parts  (not 
Including  the  “%*).  Everything  In  brackets  [ ) below  Is  optional,  so 
only  the  percent  (%)  and  the  type  are  required.  But  the  order  Is 
also  mandatory,  so  any  parts  you  DO  use  must  go  In  this  order. 


% [argument  number]  [flags]  [width]  [ .precision]  type 


, J 

leti  you  uy  WHICH 
at“t  itjuityrf.)"1''' 


T 


t 

Tkis  dc-f  ines  ike 
MINIMUM  vMiber 
of  tk ZrZtitn  ikai 
will  b e used*  That1* 
r>o{. 

TOTfrU  If  Ike 

is  1 ottyvr  ikarv  tke 
widik,  it* II  still  be  used 
i*  -full,  but  i-f  itJ*  less 
tkar\  ike  width,  it;ll  be 
yadded  witk  ze>roes. 


You  al rtidy 
tiui  «**■•■* 

frttWior-  I* 
etViev 

Jfb 

o(  d«twal  f** 

Don't 

m 

tkere- 


Tvve  is  ma^dato^Y 

and  '-ill  u»a«Y  fee 
C.*.  ^ Animal 
d , 5“  fov 

floating 
nwnfe*-- 


ml 

a 


% [argument  number]  [flags]  [width]  [ .precision]  type 


*pedi+ied  in  {His  ^eriuaf  c+v 
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The  only  required  specifier  is  for  TYPE 

Although  type  is  the  only  required  specifier,  remember  that  if  you  do  put 
in  anything  else,  type  must  always  come  last!  There  are  more  than  a dozen 
different  type  modifiers  (not  including  dates  and  times;  they  have  their  own 
set),  but  most  of  the  time  you’ll  probably  use  %d  (decimal)  or  %f  (floating 
point) . Ajid  typically  you’ll  combine  %f  with  a precision  indicator  to  set  the 
number  of  decimal  places  you  want  in  your  output. 


The  TYPE  is  mandatory,  everything  else  is  optional. 


decimal  A ,2.  Z5  „ 

format  ("%d",  42)  ; would  be  ihe 


The  argument  must  be  compatible  with  an  int,  so  that  means 
only  byte,  short,  int,  and  char  (or  their  wrapper  types) . 


floating  point 

format ("%  . 3f ",  42.000000) 


Here  »e  Combined 
with  a yretbior  »*d.Mb*r 
so  we  eroded 
three  «roes- 


The  argument  must  be  of  a floating  point  type,  so  that 
means  only  a float  or  double  (primitive  or  wrapper)  as  well 
as  something  called  BigDecimal  (which  we  don’t  look  at  in 
this  book) . 


You  must  include  a 
type  in  your  format 
instructions,  and  if  you 
specify  tilings  besides 
type,  tke  type  must 
always  come  last. 

Most  of  tke  time, 
you’ll  prokakly  format 
numbers  using  eitker 
"d”  for  decimal  or  T 
for  floating  point. 


%x  hexadecimal 

format  ("%x",  42); 


2a 


The  argument  must  be  a byte,  short,  int,  long  (including 
both  primitive  and  wrapper  types),  and  Biglnteger. 

%c  character 

format  ("%C",  42);  re?r^ 

^ char 

The  argument  must  be  a byte,  short,  char,  or  int  (including 
both  primitive  and  wrapper  types). 
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What  happens  if  I have  wore  than  one  argument? 


Imagine  you  want  a String  that  looks  like  this: 
“The  rank  is  20,456,654  out  of  100,567,890.24 


But  the  numbers  are  coming  from  variables.  What  do  you  do?  You  simply  add  two 
arguments  after  the  format  String  (first  argument),  so  that  means  your  call  to  format() 
will  have  three  arguments  instead  of  two.  And  inside  that  first  argument  (the  format 
String),  you’ll  have  two  different  format  specifiers  (two  things  that  start  with  “%”).  The 
first  format  specifier  will  insert  the  second  argument  to  the  method,  and  the  second 
format  specifier  will  insert  the  third  argument  to  the  method.  In  other  words,  the 
variable  insertions  in  the  format  String  use  the  order  in  which  the  other  arguments  are 
passed  into  the  format  ()  method. 


int  one  = 20456654; 
double  two  - 100567890 . 248907; 

String  s ~ String . format  ( "The  rank  is  %,d  out  of  %/.2£",  one,  two); 


The  rank  is  20,456,654  out  of  100,567,890.25 


We  added  Commas  -to  both  variables, 
and  resiric-fced  ihe  -floating  point 
number  (the  second  variable)  io  bno 
decimal  places. 


As  you’ll  see  when  we  get  to  date  formatting,  you  might  actually  want  to  apply  different 
formatting  specifiers  to  the  same  argument.  That’s  probably  hard  to  imagine  until  you 
see  how  date  formatting  (as  opposed  to  the  number  formating  we’ve  been  doing)  works. 
Just  know  that  in  a minute,  you’ll  see  how  to  be  more  specific  about  which  format 
specifiers  are  applied  to  which  arguments. 

Urn,  there's  something  REALLY  strange  going  on  here.  Just  how  many  arguments  can  I 
pass?  i mean,  how  many  overloaded  format()  methods  are  IN  the  String  class?  So,  what  happens 
if  I want  to  pass,  say,  ten  different  arguments  to  be  formatted  for  a single  output  String? 

A- 

Good  catch.  Yes,  there  is  something  strange  (or  at  least  new  and  different)  going  on,  and 
no  there  are  not  a bunch  of  overloaded  format!)  methods  to  take  a different  number  of  possible 
arguments.  In  order  to  support  this  new  formatting  (printf-like)  API  in  Java,  the  language  needed 
another  new  feature — variable  argument  lists  (called  varargs  for  short).  Well  talk  about  varargs 
only  in  the  appendix  because  outside  of  formatting,  you  probably  won't  use  them  much  in  a well- 
designed  system. 
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Imagine  you  want  a String  that  looks  like  this:  “Sunday,  Nov  28  2004” 

Nothing  special  there,  you  say?  Well,  imagine  that  all  you  have  to  start  with  is  a variable 
of  type  Date — A Java  class  that  can  represent  a timestamp,  and  now  you  want  to  take  that 
object  (as  opposed  to  a number)  and  send  it  through  the  formatter. 

The  main  difference  between  number  and  date  formatting  is  that  date  formats  use  a 
two-character  type  that  starts  with  “t”  (as  opposed  to  the  single  character  “F  or  “d”,  for 
example) . The  examples  below  should  give  you  a good  idea  of  how  it  works: 

The  complete  date  and  time  %tc 

String. format new  Date () ) ; 


Sun  Nov  28  14:52:41  MST  2004 


Just  the  time  %tr 

String. format ("%tr",  new  Date()); 


03:01:47  PM 


Day  of  the  week,  month  and  day 


%tA  %tB  %td 


There  isn’t  a single  format  specifier  that  will  do  exactiy  what  we 
want,  so  we  have  to  combine  three  of  them  for  day  of  the  week 
(%tA),  month  (%tB),  and  day  of  the  month  (%td). 


Date  today 
String. format ( 


words.  ..  '**  ^bet- 


new  Date  ( ) ; 

%tA,  %tB  %td" , today,  today,  today)  ^ ^ will  give  w jusf 

Tbe  Comma  is  not  part  of  -the  formatting...  it's  itts^iL6  ^ 9 4gain  to  oef 

\tts-t  tKe  Character  we  want  printed  after  the  davJh.r0*^’  ar,d  /ortk, 
Tirst  inserted  formatted  argument  *>o»th.  * tKe 


Sunday , November  2 8 


Same  as  above,  but  without  duplicating  the  arguments  %tA  %tB  %td 

Date  today  = new  Date  ( ) ; The  angle-bracket  “<"  is  just  another 

String,  format  ("%tA,  %<tB  %<td",  today) ; f ^3  m tbe  specif  ier  that  tells  the 

formatter  to  use  the  previous  argument 

Vou  can  think  of  this  as  kind  of  like  calling  three  a3am  ” * *?**  7°“  +vom  repeating  the 

different  getter  methods  on  the  Date  object,  to  arguments,  and  instead  you  format  the 

get  three  different  pieces  of  data  from  it-  same  argument  three  different  ways. 
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Working  with  Pates 

You  need  to  do  more  with  dates  than  just  get 
today  Ts  date.  You  need  your  programs  to  adjust 
dates,  find  elapsed  times,  prioritize  schedules, 
heck,  make  schedules.  You  need  industrial 
strength  date  manipulation  capabilities. 

You  could  make  your  own  date  routines  of 
course...  (and  don't  forget  about  leap  years!) 
And,  ouch,  those  occasional,  pesky  leap- 
seconds.  Wow , this  could  get  complicated.  The 
good  news  is  that  the  Java  API  is  rich  with 
classes  that  can  help  you  manipulate  dates. 
Sometimes  it  feels  a little  too  rich... 
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Moving  backward  and  forward  in  time 

Let's  say  your  company’s  work  schedule  is  Monday  through  Friday. 
You’ve  been  assigned  the  task  of  figuring  out  the  last  work  day  in 
each  calendar  month  this  year... 

It  seems  that  java.util.Date  Is  actually...  out  of  date 

Earlier  we  used  java.util.Date  to  find  today’s  date,  so  it  seems 
logical  that  this  class  would  be  a good  place  to  start  looking  for 
some  handy  date  manipulation  capabilities,  but  when  you  check 
out  the  API  you’ll  find  that  most  of  Date’s  methods  have  been 
deprecated! 

The  Date  class  is  still  great  for  getting  a “time  stamp” — an  object 
that  represents  the  current  date  and  time,  so  use  it  when  you  want 
to  say,  “give  me  NOW”. 

The  good  news  is  that  the  API  recommends  java.util. Calendar 
instead,  so  let’s  take  a look: 

Use  java.util.Calendar  for  your  date  manipulation 

The  designers  of  the  Calendar  API  wanted  to  think  globally, 
literally.  The  basic  idea  is  that  when  you  want  to  work  with  dates, 
you  ask  for  a Calendar  (through  a static  method  of  the  Calendar 
class  that  you’ll  see  on  the  next  page),  and  the  JVM  hands  you  back 
an  instance  of  a concrete  subclass  of  Calendar.  (Calendar  is  actually 
an  abstract  class,  so  you’re  always  working  with  a concrete  subclass.) 

More  interesting,  though,  is  that  the  kind  of  calendar  you  get 
back  will  be  appropriate  for  your  locale . Much  of  the  world  uses  the 
Gregorian  calendar,  but  if  you’re  in  an  area  that  doesn’t  use  a 
Gregorian  calendar  you  can  get  Java  libraries  to  handle  other 
calendars  such  as  Buddhist,  or  Islamic  or  Japanese. 

The  standard  Java  API  ships  with  java.udl.GregoiianCalendar,  so 
that’s  what  we’ll  be  using  here.  For  the  most  part,  though,  you 
don’t  even  have  to  think  about  the  kind  of  Calendar  subclass  you’re 
using,  and  instead  focus  only  on  the  methods  of  the  Calendar  class. 


For  a time-stamp  ol  "now”, 
use  Date.  But  lor  everything 
else,  use  Calendar. 
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getting  a Calendar 

tatting  an  object  that  extends  Calendar 

How  in  the  world  do  you  get  an  “instance”  of  an  abstract  class? 

Well  you  don’t  of  course,  this  won’t  work: 


This  WONT  work; 

Calendar  cal  = new  Calendar () ; 


TV  dompilev  allow  -t W\$! 


Instead,  use  the  static  Mgetlnstance()”  method; 
Calendar  cal  = Calendar .get Instance () ; 


TVs  sy^ia*  should  look  -familiar  at  'this 

- weVe  iywokmj  a static  wdhocL 


You  can’t  get  an  instance  of  Calendar, 
but  you  can  can  get  an  instance  of  a 
concrete  Calendar  subclass. 


Obviously  you  can't  get  an  instance  of  Calendar,  because 
Calendar  is  abstract.  But  you’re  still  free  to  call  static  methods 
on  Calendar,  since  sialic  methods  are  called  on  the  class, 
rather  than  on  a particular  instance.  So  you  call  the  static 
getlnstanceO  on  Calendar  and  it  gives  you  back...  an  instance 
of  a concrete  subclass.  Something  that  extends  Calendar 
(which  means  it  can  be  polymorphically  assigned  to  Calendar) 
and  which — by  contract — can  respond  to  the  methods  of  class 
Calendar. 

In  most  of  the  world,  and  by  default  for  most  versions  ofjava, 
you’ll  be  getting  back  a java.  util.  GregorianCalendar  instance. 
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Working  with  Calendar  objects 

There  are  several  key  concepts  you’ll  need  to  understand  in 

order  to  work  with  Calendar  objects: 

1 fields  hold  state-  A Calendar  object  has  many  fields  that  are  used  to 
represent  aspects  of  its  ultimate  state,  its  date  and  time.  For  instance,  you 
can  get  and  set  a Calendar’s  year  or  month. 

■ Dates  and  Times  can  be  incremented  - The  Calendar  class  has  methods  that 
allow  you  to  add  and  subtract  values  from  various  fields,  for  example  “add 
one  to  the  month",  or  “subtract  three  years". 

■ Dates  and  Times  can  be  represented  in  milliseconds  - The  Calendar  class 
lets  you  convert  your  dates  into  and  out  of  a millisecond  representation. 
(Specifically,  the  number  of  milliseconds  that  have  occured  since  January 
1st,  1970.)  This  allows  you  to  perform  precise  calculations  such  as  “elapsed 
time  between  two  times"  or  “add  63  hours  and  23  minutes  and  12  seconds 
to  this  time". 


An  example  of  working  with  a Calendar  object: 

Calendar  c = Calendar  .getlnstance  d'- 
etat (2004  , 0,7  , 15  , 40)  ; 
long  dayl  = c. getTimelnMillia () ; 
dayl  +-  1000  * 60  * 60; 
c. aatTimelnMillis (dayl) ; ^ 

System,  out  .println  ("new  hour  " -f  c.get  (c.  HOtJR_OF_DAY)  ) 

c . add (c .DATE , 35);  

System. out. println ("add  35  days  " + c.getTimeO); 

c. roll (c. DATE,  35);  ^ — 

System,  out  .println  ("roll  35  days  " + c.getTimeO), 
c . set  (c . DATE , 1 ) ; ^ 


. 1 lock  at 

/Sdd  a*  W“s  ot  milk  tx«r,  upda-b  tW- 

(M* u the  “+<  iti  like  aayl  - dayl  + •••). 


Add  Vi>  days  to  the  daie,  whieh 

iKould  move  w into  February. 


System. out . println ("set  to  1 " + c .getTime () ) ; 


Roll  ^ 35  days  onto  this  dale.  This 
the  dafe  ah tad  35  days,  but 
DOFS  HOT  4ha^gc  the  ftiOhxh  I 

doin5  I?Sfdabr<* 


| Fh  Erft  WWow  Hft!p  TTme^iw 


Rsw  hour  16 

add  35  days  Wed  Feb  11  16:40:41  MET  2004 
roll  35  days  Tue  Feb  17  16:40:4!  MST  2004 
set  to  1 Sun  Feb  01  16:40:41  MS?  2004 


This  outfit  Corvfirms  how  millis, 
add , roll,  a^d  set  work- 
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Highlights  of  the  Calendar  API 

We  just  worked  through  using  a few  of  the  fields  and 
methods  in  the  Calendar  class.  This  is  a big  API  so 
we’re  showing  only  a few  of  the  most  common  fields 
and  methods  that  you’ll  use.  Once  you  get  a few  of 
these  it  should  be  pretty  easy  to  bend  the  rest  of  the 
this  API  to  your  will, 


Key  Calendar  Methods 


adddnt  field,  int  amount) 

Adds  or  subtracts  time  from  the  calendar's  field. 

getdnt  field) 

Returns  the  value  of  the  given  calendar  field. 

getlnstancel) 

Returns  a Calendar, you  can  specify  a locale. 

getTImelnMillisO 

Returns  this  Calendar's  time  In  mlllis,  as  a long. 

roil(int  field,  boolean  up) 

Adds  or  subtracts  time  without  changing  larger  fields. 


set(int  field,  int  value) 

Sets  the  value  of  a given  Calendar  field. 

set(year,  month,  day,  hour,  minute)  (all  ints) 

A common  variety  of  set  to  set  a complete  time. 

setTimelnMillis(long  mlllis) 

Sets  a Calendar's  time  based  on  a long  mllli-time. 

//  more... 


Calendar  Fields 
°ATEg«  /DA.Vtof-Month 


set  the  day  of  month 

hour / hour  _0,  day 

Get/  set  the  1 y h 

wuisecoNo  ou'orJ4h°— 

Get  / set  the  mffliSecond5 

minute 

Get /set  the  minute. 

MONTH 

Get /set  the  month 

VEAR 

Get  'set  the  year. 

ZONE^OFFSET 

Get/ set  raw  offset  of  GMT  I 

//more... 


‘In  minis. 
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Even  more  Statics!...  static  imports 

New  to  Java  5.0...  a real  mixed  blessing.  Some  people  love 
this  idea,  some  people  hate  iL  Static  imports  exist  only  to  save 
you  some  typing.  If  you  hate  to  type,  you  might  just  like  this 
feature.  The  downside  to  static  imports  is  that  - if  you're  not 
careful  - using  them  can  make  your  code  a lot  harder  to  read. 

The  basic  idea  is  that  whenever  you're  using  a static  class,  a 
static  variable,  or  an  enum  (more  on  those  later),  you  can 
import  them,  and  save  yourself  some  typing. 


Soma  old-fashioned  code: 

import  java . lang . Math; 

class  NoStatic  { 


Use  Carefully: 

static  imports  can 
make  your  code 
confusing  to  read 


public  static  void  main (String  ()  args)  ( 

System. out .println ("sqrt  " + Math. sqrt (2 . 0) ) ; 
System. out . println ("tan  " + Math. tan (60)); 


) 


-rw 


) 


Same  code,  with  static  Imports: 

import  static  java . lang . System,  out ; 
import  static  java. lang. Math.*; 

class  WithStatic  ( 

public  static  void  main (String  []  args)  ( 
out .println ("sqrt  " + aqrt(2.0)); 
out .println ("tan  " + tan(60)); 

) 


imports  attion* 


Caveats  & fofchas 


If  you're  only  going  to  use  a static  member 
a few  times,  we  think  you  should  avoid 
static  imports,  to  help  keep  the  code  more 
readable. 

If  you're  going  to  use  a static  member  a lot, 
(like  doing  lots  of  Math  calculations),  then 
it’s  probably  OK  to  use  the  static  Import. 

Notice  that  you  can  use  wildcards  (.*),  in 
your  static  Import  declaration. 

A big  issue  with  static  imports  is  that  it's 
not  too  hard  to  create  naming  conflicts.  For 
example,  if  you  have  two  different  classes 
with  an  ‘addO*  method,  how  will  you  and 
the  compiler  know  which  one  to  use? 
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Tonight's  Talk:  An  instance  variable 
takes  cheap  shots  at  a static  variable 


Instance  Variable  Static  Variable 

I don't  even  know  why  we're  doing  this. 

Everyone  knows  static  variables  are  just  used 
for  constants.  And  how  many  of  those  are 
there?  I think  the  whole  API  must  have,  what, 
four?  And  it's  not  like  anybody  ever  uses 
them. 

You  really  should  check  your  facts.  When 
was  the  last  time  you  looked  at  the  APP  It's 
Pickin'  loaded  with  statics!  It  even  has  endre 
classes  dedicated  to  holding  constant  values. 
There's  a class  called  SwingConstants,  for 
example,  that’s  just  full  of  them. 

Full  of  it.  Yeah,  you  can  say  that  again.  OK, 
so  there  are  a few  in  the  Swing  library,  but 

everybody  knows  Swing  is  just  a special  case.  It  might  be  a special  case,  but  it’s  a really 

important  one)  And  what  about  the  Color 
class?  W^hat  a pain  if  you  had  to  remember  the 
RGB  values  to  make  the  standard  colors?  But 
the  color  class  already  has  constants  defined 
for  blue,  purple,  white,  red,  etc.  Very  handy. 


How’s  System, out  for  starters?  The  out  in 
System.out  is  a static  variable  of  the  System 
class.  You  personally  don't  make  a new 
instance  of  the  System,  you  just  ask  the  System 
class  for  its  out  variable. 

Well,  that's  another  special  case.  And  nobody 

uses  that  except  for  debugging  anyway.  0h>  UUe  debugging  isn’t  important? 

And  heres  something  that  probably  never 
crossed  your  narrow  mind — let’s  face  it,  static 
variables  are  more  efficient.  One  per  class 
instead  of  one  per  instance.  The  memory 
savings  might  be  huge! 


Ok,  but  besides  a few  GUI  things,  give  me  an 
example  of  just  one  stadc  variable  that  anyone 
would  actually  use.  In  the  real  world. 


Fireside  Ghats 
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Instance  Variable 

Um,  aren’t  you  forgetting  something? 

Static  variables  are  about  as  un-OO  as  it  gets!! 
Gee  why  not  just  go  take  a giant  backwards 
step  and  do  some  procedural  programming 
while  we’re  at  it. 

You’re  like  a global  variable,  and  any 
programmer  worth  his  PDA  knows  that’s 
usually  a Bad  Thing. 


Yeah  you  live  in  a class,  but  they  don’t  call 
it  Cfas$-Oriented  programming.  That’s  just 
stupid.  You’re  a relic.  Something  to  help  the 
old-timers  make  the  leap  to  java. 


Well,  OK,  every  once  in  a while  sure,  it  makes 
sense  to  use  a static,  but  let  me  tell  you,  abuse 
of  static  variables  (and  methods)  is  the  mark 
of  an  immature  OO  programmer.  A designer 
should  be  thinking  about  object  state,  not  class 
state. 

Static  methods  are  the  worst  things  of  all, 
because  it  usually  means  the  programmer  is 
thinking  procedurally  instead  of  about  objects 
doing  things  based  on  their  unique  object 
state. 


Riiiiiight.  Whatever  you  need  to  tell  yourself... 


Static  Variable 

What? 


What  do  you  mean  un-OO? 


I am  NOT  a global  variable.  There’s  no  such 
thing.  I live  in  a class!  That’s  pretty  OO  you 
know,  a CLASS.  I’m  not  just  sitting  out  there 
in  space  somewhere;  I’m  a natural  part  of  the 
state  of  an  object;  the  only  difference  is  that 
I’m  shared  by  all  instances  of  a class.  Very 
efficient. 


Alright  just  stop  right  there.  THAT  is 
definitely  not  true.  Some  static  variables  are 
absolutely  crucial  to  a system.  And  even  the 
ones  that  aren’t  crucial  sure  are  handy. 


Why  do  you  say  that?  And  what’s  wrong  with 
static  methods? 


Sure,  I know  that  objects  should  be  the  focus 
of  an  OO  design,  but  just  because  there  are 
some  clueless  programmers  out  there...  don’t 
throw  the  baby  out  with  the  bytecode.  There’s 
a time  and  place  for  statics,  and  when  you 
need  one,  nothing  else  beats  it. 


you  are  here  ► 


309 


be  the  compiler 


class  StaticSuper{ 


static  { 


BE  die  compel 


The  Java  file  on  tkis  page  represents  a 
complete  program.  Your  job  is  to  play 
compiler  and  determine  whether  this 
file  will  compile.  If  it  won’t  compile, 
how  would  yon  fix  it,  and 
if  it  does  compile,  what 
would  be  its  output? 


System,  out,  println<  " super  static  block.'1); 


} 


StaticSuperf 

System. out. print In < 

"super  constructor"); 

> 

> 

public  class  StaticTests  extends  StaticSuper  { 
static  int  rand; 

static  { 

rand  = ( int ) ( Math . random ( ) * 6 ) ; 

System. out. println("static  block.  " + rand); 

> 

StaticTests ( ) { 

System. out .println( "constructor" ) ; 

> 

public  static  void  main{String  []  args)  { 
System. out . println ( "in  main"); 

StaticTests  st  - new  StaticTests () ; 

> 


If  it  compiles,  which  of  these  Is 
the  output? 


Possible  Output 


■ ill ■ ' iw  ill ii1  ii in iii 

%java  StaticTests 

static  block  4 

in  main 

super  static  block 

super  constructor 

constructor 

Possible  Output 

| Rle  Edit  Window  Hetp  ElectHdty  | 


%java  StaticTests 
super  static  block 
static  block  3 
in  main 

super  constructor 
constructor 


310  chapter  10 


numbers  and  statics 


This  chapter  explored  the  wonderful,  static,  world 
of  Java.  Your  job  is  to  decide  whether  each  of  the 
following  statements  Is  true  or  false. 

ok  FaLse^f 


1.  To  use  the  Math  class,  the  first  step  is  to  make  an  instance  of  it. 

2.  You  can  mark  a constructor  with  the  static  keyword. 

3.  Static  methods  don’t  have  access  to  instance  variable  state  of  the  ‘this’  object 

4.  It  is  good  practice  to  call  a static  method  using  a reference  variable. 

5.  Static  variables  could  be  used  to  count  the  instances  of  a class. 

6.  Constructors  are  called  before  static  variables  are  initialized. 

7.  MAX_SIZE  would  be  a good  name  for  a static  final  variable. 

8.  A static  initializer  block  runs  before  a class’s  constructor  runs. 

9.  If  a class  is  marked  final,  all  of  its  methods  must  be  marked  final. 

10.  A final  method  can  only  be  overridden  if  its  class  is  extended. 

11.  There  is  no  wrapper  class  for  boolean  primitives. 

12-  A wrapper  is  used  when  you  want  to  treat  a primitive  tike  an  object 

13.  The  parseXxx  methods  always  return  a String, 

14.  Formatting  classes  (which  are  decoupled  from  I/O),  are  in  the  java.format 
package. 


you  are  here  > 311 


code  magnets 


Lunar  Code  Magnets 

This  one  might  actually  be  useful!  In  addition  to  what  youVe  learned  in  the  last  few 
pages  about  manipulating  dates, you'll  need  a little  more  information...  First  full 
moons  happen  every  29.52  days  or  so.  Second,  there  was  a full  moon  on  Jan,  7th, 
2004.  Your  job  is  to  reconstruct  the  code  snippets  to  make  a working  Java  program 
that  produces  the  output  listed  below  (plus  more  full  moon  dates),  (You  might  not 
need  all  of  the  magnets,  and  add  all  the  curly  braces  you  need.)  Oh,  by  the  way,  your 
output  will  be  different  if  you  don't  live  in  the  mountain  time  zone. 


| Fite  Ed it  Window  Wp  Hod 

% java  FullMoons 

full  moon  on  Fri 

Feb 

06 

04:09:35 

MST 

2004 

full  moon  on  Sat 

Mar 

06 

16:38:23 

MST 

2004 

full  moon  on  Mon 

Apr 

05 

06:07:11 

MOT 

2004 

c,  j 


static  import  java . lang . System,  out ; 

i 

c. set(2004, 0,7, 15,40) ; 

(String. format 
Calendar  c = Calendar . getlnstance ( ) ; 
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Exercise  Solutions 


True  or  False 


BE  die  compiler 

StaticSuper(  ) { 

System . out . println ( 
"super  constructor" ) ; 


> 


StaticSuper  is  a constructor,  and  must 
have  ( ) in  its  signature.  Notice  that  as 
the  output  below  demonstrates,  the  static 
blocks  for  both  classes  run  before  either 
of  the  constructors  run. 


Possible  Output 


%java  StaticTests 

super  static  block 

static  block  3 

in  main 

super  constructor 

constructor 

1 . To  use  the  Math  class,  the  first  step  is  to 
make  an  instance  of  it. 

2.  You  can  mark  a constructor  with  the  key- 
word ‘static’. 

3.  Static  methods  don’t  have  access  to  an 
object’s  instance  variables. 

4.  It  is  good  practice  to  call  a static  method 
using  a reference  variable. 

5.  Static  variables  could  be  used  to  count  the 
instances  of  a class. 

6.  Constructors  are  called  before  static  vari- 
ables are  initialized. 

7.  MAX_SIZE  would  be  a good  name  for  a 
static  final  variable. 

8.  A static  initializer  block  runs  before  a class’s 
constructor  runs. 

9.  If  a class  is  marked  final,  all  of  its  methods 
must  be  marked  final. 

10.  A final  method  can  only  be  overridden  if 
its  class  is  extended. 

1 1 . There  is  no  wrapper  class  for  boolean 
primitives. 

12.  A wrapper  is  used  when  you  want  to  treat  a 
primitive  like  an  object. 

13.  The  parseXxx  methods  always  return  a 
String. 

1 4.  Formatting  classes  (which  are  decoupled 
from  I/O),  are  in  thejava.format  package. 


False 

False 

True 

False 

True 

False 

True 

True 

False 

False 

False 

True 

False 

False 
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code  magnets  solution 


Exercise  Solutions 


Import  java .util . * ; 

import  static  java . lang. System. out ; 
class  FullMoons  { 

static  int  DAY_IM  = 1000  * 60  * 60  * 24, 
public  static  void  main (String  [)  args)  { 
Calendar  c = Calendar , ge tins tance () ; 
e . set (2004,0,7/15,40) ; 
long  dayl  = c . getTlmelnMillis () ; 
for  (int  x =»  0;  x < 60;  x-M-)  ( 

dayl  +=  (DAY_IM  * 23.52) 
c . setTimelnMillis (dayl) ; 
out .println (String. format (“full  moon 


Notes  on  the  Lunar  Code  Magnet: 

You  might  discover  that  a few  of  the 
dates  produced  by  this  program  are 
off  by  a day.  This  astronomical  stuff 
is  a little  tricky,  and  if  we  made  it 
perfect,  it  would  be  too  complex  to 
make  an  exercise  here. 

Hint:  one  problem  you  might  try  to 
solve  is  based  on  differences  in  time 
zones.  Can  you  spot  the  issue? 


on  %tc" , c) ) ; 


} 


) 


) 


Fit  £«  Wlrdw  Htlp  Hetf 


% java  FullMoons 

full  moon  on  Fri  Feb  06  04:09:35  MST  2004 
full  moon  on  Sat  Mar  06  16:36:23  MST  2004 
full  moon  on  Mon  Apr  05  06:07:11  MDT  2004 
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Risky  Behavior 


Stuff  happens.  The  file  isn’t  there.  The  server  is  down.  No  matter  how 

good  a programmer  you  are, you  can't  control  everything. Things  can  go  wrong.  Very  wrong. 
When  you  write  a risky  method, you  need  code  to  handle  the  bad  things  that  might  happen. 

But  how  do  you  know  when  a method  Is  risky?  And  where  do  you  put  the  code  to  hondle  the 
exceptional  situation?  So  far  in  this  book,  we  haven't  reolfy  taken  any  risks.We've  certainly  had 
things  go  wrong  at  runtime,  but  the  problems  were  mostly  flaws  in  our  own  code.  Bugs.  And 
those  we  should  fix  at  development  time.  No,  the  problem-handling  code  we're  talking  about 
here  is  for  code  that  you  can't  guaranatee  will  work  at  runtime.  Code  that  expects  the  file  to  be 
in  the  right  directory,  the  server  to  be  running,  or  theThread  to  stay  asleep.  And  we  have  to  do 
this  now.8ecause  In  this  chapter,  we're  going  to  build  something  that  uses  the  risky  JavaSound 
API.  We're  going  to  build  a MIDI  Music  Player. 
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building  the  MIDI  Music  Player 


let's  make  a Music  Machine 


Over  the  next  three  chapters,  we'll  build  a few  different  sound 
applications,  including  a BeatBox  Druin  Machine.  In  fact, 
before  the  book  is  done,  we'll  have  a multi-player  version  so 
you  can  send  your  drum  loops  to  another  player,  kind  of  like 
a chat  room.  You're  going  to  write  the  whole  thing,  although 
you  can  choose  to  use  Ready-bake  code  for  the  GUI  parts. 

OK,  so  not  every  IT  department  is  looking  for  a new  BeatBox 
server,  but  we’re  doing  this  to  learn  more  about  Java.  Building 
a BeatBox  is  just  a way  to  have  fun  we're  Iearningjava. 

The  finished  BeatBox  looks  something  like  this; 


”'ke  a H-  <*  <M«t  *».  ntw 
by  tkoUjritt  i„  tke  ^ r 


600 


Cyber  BeatBox 


Bass  Drum  S000S000S0.00SIBOD 
Closed  Hi-Hat  □□gOQQSjBQDSDDDSj® 

openni-Hat  GGOQGQOQGDOQOQGO 

Acoustic  Snare  Q Q Q □ G G G 0 Q G 0QO  O G □ 
Crash  Cymbal  GGGG  GGGGGGGOGG  _G 


HandClap  □□□□□□□□□□□□QOQD 

High  Tom  □□□□□□  QO DOG QQO □ G 

Hi  Bongo  □ □□□□□□□□ODDMtfD 

Maracas  0G@SG@5GS!D@a0O0G0G 

Whistle  □□□□□0000000OQQD 

Lowconga  GC:_iGGQ0G(Gel0G0GQG 

Cowbell  □□□□□□□□□□□□□□□□ 

Vlbraslap  □□OOQOGQGOQQGQQG 

low-rmid  Tom  □ □□□  □□  □□  DODDDOOD 

High  Agogo  □□□□□□□□□□□OG  □□□ 

Open  HI  CongaG QQg|G!S0DOQGGQ000G 


c 

Start 

c 

Stop 

3 

c 

Tempo 

Up_) 

c 

Tempo 

Down  ) 

c 

send  It 

3 

Andy:  groove  #2 
Chris:  groove2  revised 4 
Nigel:  dance  beat 


Put  checkmarks  in  the  boxes  for  each  of  the  16  'beats’*  For  example,  on  beat 
1 (of  16)  the  Bass  drum  and  the  Maracas  will  play,  on  beat  2 nothing,  and 
on  beat  3 the  Maracas  and  Closed  Ki-Hat...  you  get  the  idea.  When  you  hit 
'Start’,  it  plays  your  pattern  in  a loop  until  you  hit  ‘Stop’*  At  any  time,  you 
can  "capture”  one  of  your  own  patterns  by  sending  it  to  the  BeatBox  server 
(which  means  any  other  players  can  listen  to  it) . You  can  also  load  any  of  the 
incoming  patterns  by  clicking  on  the  message  that  goes  with  it. 


fiSVa.t  -ttet  yk 

T"  ^‘1 


^ elk 
Ud  dc  Jr*  T 

tots  wi-th  a [ tbi 

to  d,ik 
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Well  start  with  the  basics 

Obviously  we’ve  got  a few  things  to  learn  before  the  whole 
program  is  finished,  including  how  to  build  a Swing  GUI,  how 
to  connect  to  another  machine  via  networking,  and  a litde  I/O 
so  we  can  send  something  to  the  other  machine. 


Oh  yeah,  and  theJavaSound  API.  That's  where  well  start  in  this 
chapter.  For  now,  you  can  forget  the  GUI,  forget  the  networking 
and  the  I/O,  and  focus  only  on  getting  some  MIDI-generated 
sound  to  come  out  of  your  computer.  And  don’t  worry  if  you 
don’t  know  a thing  about  MIDI,  or  a thing  about  reading  or 
making  music.  Everything  you  need  to  learn  is  covered  here. 

You  can  almost  smell  the  record  deaf 

the  JavaSound  API 

JavaSound  is  a collection  of  classes  and  interfaces  added  to 
Java  starting  with  version  1 .3.  These  aren’t  special  add-ons; 
they’re  part  of  the  standard  J2SE  class  library.  JavaSound  is  split 
into  two  parts;  MIDI  and  Sampled.  We  use  only  MIDI  in  this 
book.  MIDI  stands  for  Musical  Instrument  Digital  Interface, 
and  is  a standard  protocol  for  getting  different  kinds  of 
electronic  sound  equipment  to  communicate.  But  for  ec 

our  BeatBox  app,  you  can  think  of  MIDI  as  a kind  of  ^ 

sheet  music  that  you  feed  into  some  device  you  can  think 
of  like  a high-tech  'player  piano’.  In  other  words,  MIDI  V ^ 
data  doesn’t  actually  include  any  sound,  but  it  does  \ 

include  the  instructions  that  a MIDI-reading  instrument  ^ 

can  play  back.  Or  for  another  analogy,  you  can  think  of 
a MIDI  file  like  an  HTML  document,  and  the  instrument 
that  renders  the  MIDI  file  (he.  plays  it)  is  like  the  Web 
browser. 

MIDI  data  says  what  to  do  (play  middle  C,  and  here’s  how  hard 
to  hit  it,  and  here’s  how  long  to  hold  it,  etc.)  but  it  doesn’t  say 
anything  at  all  about  the  actual  sound  you  hear.  MIDI  doesn’t 
know  how  to  make  a flute,  piano,  or  Jimmy  Hendrix  guitar 
sound.  For  the  actual  sound,  we  need  an  instrument  (a  MIDI 
device)  that  can  read  and  play  a MIDI  file.  But  the  device  is 
usually  more  like  an  entire  band  or  orchestra  of  instruments.  And 
that  instrument  might  be  a physical  device,  like  the  electronic 
keyboard  synthesizers  the  rock  musicians  play,  or  it  could 
even  be  an  instrument  built  entirely  m software,  living  in  your 
computer. 

For  our  BeatBox,  we  use  only  the  built-in,  software-only 
instrument  that  you  get  with  Java.  It’s  called  a synthesizer  (some 
folks  refer  to  it  as  a software  synth)  because  it  creates  sound. 

Sound  that  you  hear. : 


MlPl 

ftay 

ar*d  VwM I 


t«r  a W* 


A1|P|  divide  k»owi  Kow  to 
Wad'  a M|D|  lile  and  flay  badk 
the  sound.  The  device  mi  jkt 
be  a synthesizer  keyboard  or 
some  other  kind  of  instrument- 
Usually,  a fA\ Dl  instrument 
Can  play  a LOT  of  diff erent 

sound*  fpiano,  drums,  violin, 

et £-))  and  all  at  the  sa^e  ti»e- 
£o  a W|D|  file  isnt  like  sheet 
music  for  just  one  musician  in 
the  band  — it  Can  hold  the 
parts  for  ALL  the  musicians 
playing  a particular  song. 
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but  it  looked  so  simple 


First  we  need  a Sequencer 

Before  we  can  get  any  sound  to  play,  we  need  a Sequencer  object.  The 
sequencer  is  the  object  that  takes  all  the  MIDI  data  and  sends  it  to  the  right 
instruments.  It’s  the  thing  that  plays  the  music.  A sequencer  can  do  a lot  of 
different  things,  but  in  this  book,  weTe  using  it  strictly  as  a playback  device.  Like 
a CD-player  on  your  stereo,  but  with  a few  added  features.  The  Sequencer  class 
is  in  the  javax.sound.midi  package  (part  of  the  standard  Java  library  as  of  version 
L3) . So  let's  start  by  making  sure  we  can  make  (or  get)  a Sequencer  object. 


import  javax.  sound  .midi . * ; 
public  class  MusiaTestl  { 


public  void  play()  { 

Sequencer  sequencer  = MidiSys tern .gets equencer () 


d Stc^tr  objefct  It*  £ 

.» l+’»  y,t  * 

MIDI  mWaW 


System. out. println ("We  got  a sequencer") ; 
} II  close  play 


all  ^ ; L 


public  static  void  main (String []  args)  ( 
MusicTestl  mt  = new  MusicTestl () ; 
mt.play () ; 

) //  close  main 
} II  close  class 


FllQ  Edil  Window  Halp  SayWtal?  ^ 


% javac  MusicTestl . java 

MusicTestl . java : 13 : unreported  exception  javax . sound .midi . 
MidiUnavailableException ; must  be  caught  or  declared  to  be 
thrown 

Sequencer  sequencer  = MidiSystem. getSequencer ( ) ; 

A 

1 errors 


Something's  wrong! 

Tills  to&t  won  t ton, pile/  Tll«  £or*pi|«>-  sjys  -thug's 

hWneT#^d  that  *wi  be  Mujbt  «-  Glared. 
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What  happens  when  a method  you  want  to  call 
(probably  in  a class  you  didn't  write)  is  risky? 


exception  handling 


0 Let’s  say  you  want 
to  call  a method  in  a 
class  that  you  didn't 
write. 


didn't  write 


^ That  method  does 
something  risky, 
something  that  might 
not  work  at  runtime. 


^ You  need  to  know 
that  the  method 
you’re  calling  is 
risky. 


^ You  then  write  code 
that  can  handle  the 
failure  if  it  does 
happen.  You  need  to  be 
prepared,  just  in  case. 


class  you 
didn't  write 


void  moo ( ) { 

if  (serverDown)  { 
explode () ; 

> 

> 
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when  things  might  go  wrong 

Java  s exception-handling  merfi^  • 

"f  o* *>«  « £ SEJ£> ™ «* . £ » i;“Pt  x r„  ->«  «5*  jl, 

««PO»n  '^«'»r-p«slbl,  ew„  rKm„Za"",Z  r°t  a Pmfcubr 

So.howdoyoui^^y  pr0  fen“l»lonwd 

method's  dedatodon  AOd  ‘hrew  “ Vou  find  a ttr  , 

a ^ows  clause  in  the 


^ '**  <*  w 

y Sj  ««erf>.  <h«  ^ 
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“fyHed,  aaeAu/,.,  fib 


The  compiler  needs  to  know 
that  YOU  know  you're  calling 
a risky  method. 


If  you  wrap  the  risky  code  in  something  called  a 
try/catch,  the  compiler  will  relax. 

A try/ catch  block  tells  the  compiler  that  you 
know  an  exceptional  thing  could  happen  in  the 
method  you’re  calling,  and  that  you’re  prepared 
to  handle  it  That  compiler  doesn't  care  how  you 
handle  it;  it  cares  only  that  you  say  you're  taking 
care  of  it. 


Import  javax.  sound,  midi 


public  class  MusicTestl  { 
public  void  play()  { 


} catch  (MidiUnavailableException  ex)  { 


} 


System. out. println  ("Bummar")  ; 


) //  close  play 


public  static  void  main {StringCl  args)  { 
MusicTestl  mt  = new  MusicTestl () ; 
mt.play ()  ; 

} //  close  main 
} //  close  class 
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3&s 


DGrO  Iry  ifl 


An  exception  is  an  object... 
of  type  Exception. 

Which  is  fortunate,  because  it  would  be  much  harder 
to  remember  if  exceptions  were  of  type  Broccoli. 

Remember  from  your  polymorphism  chapters  that 
an  object  of  type  Exception  can  be  an  instance  of  any 
subclass  of  Exception* 

Became  an  Exception  is  an  object,  what  you  catch  is  an 
object.  In  the  following  code,  the  catch  argument 
is  declared  as  type  Exception,  and  the  parameter 
reference  variable  is  ex. 

try  { 

//  do  risky  thing  .l',  ^ 

} catch (Exception  ex)  { 

//  try  to  recover 

} ^ This  ccde  , 


What  you  write  in  a catch  block  depends  on  the 
exception  that  was  thrown*  For  example,  if  a server 
is  down  you  might  use  the  catch  block  to  try  another 
server.  If  the  file  isn't  there,  you  might  ask  the  user 
for  help  finding  it. 
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If  it's  your  code  that  catches  the  exception, 
then  whose  code  throws  it? 

You  *11  spend  much  more  of  your  Java  coding  time  handling 
exceptions  than  you *11  spend  creatingBiid  throwing  them  yourself. 

For  now,  just  know  that  when  your  code  calls  a risky  method — a 
method  that  declares  an  exception — it*s  the  risky  method  that 
throws  the  exception  back  to  you,  the  caller 

In  reality,  it  might  be  you  who  wrote  both  classes.  It  really 
doesn't  matter  who  writes  the  code...  what  matters  is  knowing 
which  method  throws  the  exception  and  which  method  catches  it. 


your 


doss  with  a 
risky  method 


When  somebody  writes  code  that  could  throw  an  exception,  they 
must  declare  the  exception. 


w ^ 

Risky,  exception-throwing  code:  ^'s  nt  vt 

“ AttU'rW  w - 


public  void  t&keRiskQ  t&rpw  BadException  { 
if  ( abandonAl lHope)  { 

throw]  new  BadException ()  ; 


1 


) 


\ 


okju{ 


| Your  code  that  calls  the  risky  method: 

public  void  crossFingers ()  ( 
try  [{ 

anObject. takeRlsk() ; 

> catch  (BadException  ex)  { 

System . out . println ( "Aaargh ! " ) ; 
ex . printStaokTrace ( ) ; 


One  method  Will 
catch  vvf>nt  another 
method  throws.  An 
exception  is  always 
thrown  hack  to  the 
cal  ler. 

The  method  that 
throws  has  tP  declare 
that  It  mltik  throw 
the  exception. 


“rJt 
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checked  and  unchecked  exceptions 


ttat  are  HOT  subclasses  «f 
/?uhti«eEnCepfco»  are  checked  -for  by 
the  Compiler.  They're  called  "checked 


The  compiler  checks  for  everything 
except  RuntlmeExceptions. 

The  compiler  guarantees: 


If  you  throw  an  exception  in  your  code  you  must  declare  it  using 
the  throws  keyword  in  your  method  declaration. 


Wait  just  a mlnutel  How  come  this  is  the  FIRST  time 
we’ve  had  to  try/catch  an  Exception?  What  about  the 
exceptions  I've  already  gotten  like  NullPointerException 
and  the  exception  for  DivideByZero.  I even  got  a 
NumberFormatException  from  the  IntegerparselntQ 
method*  How  come  we  didn't  have  to  catch  those? 

J^Z  The  compiler  cares  about  all  subclasses  of  Exception, 
unless  they  are  a special  type,  RuntimeException.  Any 
exception  class  that  extends  RuntimeException  gets  a 
free  pass.  RuntimeExceptfons  can  be  thrown  anywhere, 
with  or  without  throws  declarations  or  try/catch  blocks. 
The  compiler  doesn't  bother  checking  whether  a method 
declares  that  It  throws  a RuntimeException,  or  whether  the 
caller  acknowledges  that  they  might  get  that  exception  at 
runtime. 


bite.  WHY  doesn't  the  compiler  care  about  those 
runtime  exceptions?  Aren't  they  just  as  likely  to  bring  the 
whole  show  to  a stop? 

Most  RuntlmeExceptions  come  from  a problem  in 
your  code  logic,  rather  than  a condition  that  fails  at  runtime 
in  ways  that  you  cannot  predict  or  prevent.  You  cannot 
guarantee  the  file  is  there.  You  cannot  guarantee  the  server 
is  up.  But  you  can  make  sure  your  code  doesn't  index  off  the 
end  of  an  array  (that's  what  the  .length  attribute  is  for). 

You  WANT  RuntlmeExceptions  to  happen  at  development 
and  testing  time.  You  don't  want  to  code  in  a try/catch,  for 
example,  and  have  the  overhead  that  goes  with  it,  to  catch 
something  that  shouldn't  happen  in  the  first  place. 

A try/catch  is  for  handling  exceptional  situations,  not  flaws 
in  your  code.  Use  your  catch  blocks  to  try  to  recover  from 
situations  you  can't  guarantee  will  succeed.  Or  at  the  very 
least,  print  out  a message  to  the  user  and  a stack  trace,  so 
somebody  can  figure  out  what  happened. 
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V^connect  to  a remote  server  the  server  is  down 

Which  of  these  do  you  think 

might  throw  an  exception  that  _ access  an  array  beyond  its  length  

the  compiler  would  care  about?  _ display  a window  on  the  screen  

We're  only  looking  for  the 

things  that  you  can't  control  In  _ retrieve  data  from  a database 

your  coda.  We  did  the  first  one.  see  if  a text  file  is  where  you  think  it  is  

(Because  It  was  the  easiest.)  _ create  a new  file  

read  a characterfrom  the  command-Une 
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exceptions  and  flow  control 

Flow  control  in  try/catch  blocks 

When  you  caJl  a risky  method,  one  of  two  things  can  hap- 
pen. The  risky  method  either  succeeds,  and  the  try  block 
completes,  or  die  risky  method  throws  an  exception  back  to 
yonr  calling  method. 


If  the  try  Succeeds 


(doRiskyThlngQ  does  not 
throw  an  exception) 


try  { 


taU'' 


@ Poo  f = X.doRiskyThingO;  -p*  to&t  in 

int  b = f .getNumO  ; ta-ttV*  W«rfk  »t*er 


} catch  (Exception  ex)  { ^ 

System. out. println ("failed") ; 

File  Edh  WndOrf  Hdp  RfekAII  | 

%java  Tester 
We  made  it? 

@ — > System. out. println ("We  made  it!"); 

If  the  try  fails 

(because  doRKskyThlngO 
does  throw  an  exception) 


**'*t£r^"**f 

tu„ 


ttfk.  • 


x.doRiskyThingO  ; 
f .getNum () ; 


Jt  TV'^ 

Tbe*6"*  ,.,v\s  a M 

^ aoP.^'’5  ' 

yt\« u' 


(Jr\e  ’ 


) catch  (Exception  ex)  { 

System. out. println ("failed") ; 


i System. out. println ("We  made  it!")/ 


I me.  Edit  Window  Help  fti&HAJI 


%java  Tester 

failed 

We  made  it! 
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Finally:  for  the  things  you  want 
to  do  no  matter  what 


exception  handling 


If  you  try  to  cook  something,  you  start  by  turning  on 
the  oven. 

If  the  thing  you  try  is  a complete  failure, 
you  hove  to  turn  off  die  oven. 

If  the  thing  you  try  succeed s, 
you  hove  to  turn  off  the  oven. 

You  hove  to  turn  off  the  oven  no  matter  what! 

A Anally  block  is  where  you  put 
code  that  must  run  regardless 
of  an  exception. 

try  { 

turnOvenOn () ; 
x. bake  ()  ; 

) catch  (BakingException  ex)  { 
ex . prints tackTrace () ; 

) finally  { 

turnOvenOf f ( ) ; 

> 

Without  finally,  you  have  to  put  the 
tumOvenOff()  in  both  the  try  and  the  catch 
because  you  have  to  turn  off  the  oven  no  matter 
what , A finally  block  lets  you  put  all  your 
important  cleanup  code  in  one  place  instead  of 
duplicadng  it  like  this: 

try  { 

turnOvenOn () ; 
x.bake  0 ; 
turnOvenOf f ( ) ; 

} catch  (BakingException  ex)  { 
ex.printStackTrace  () ; 
turnOvenOf f () ; 

} 


If  the  try  block  falls  (an  exception),  flow 
control  immediately  moves  to  the  catch  block. 
When  the  catch  block  completes,  the  finally 
block  runs.  When  the  finally  block  completes, 
the  rest  of  the  method  continues  on. 

If  the  try  block  succeeds  (no  exception), 
flow  control  skips  over  the  catch  block  and 
moves  to  the  finally  block.  When  the  finally 
block  completes,  the  rest  of  the  method 
continues  on. 

If  the  try  or  catch  block  has  a return 
statement,  finally  will  still  runl  Flow 
jumps  to  the  finally,  then  back  to  the  return. 
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flow  control  exercise 


Flow  Control 


Look  at  the  code  to  the  left.  What  do  you  think  the 
output  of  this  program  would  be?  What  do  you  think 
It  would  be  If  the  third  line  of  the  program  were 
changed  to:  String  test  - "yes”;  ? 

Assume  Scary  Exception  extends  Exception. 


public  class  TestExceptions  { 

public  static  void  main(String  []  args)  { 

String  test  = "no"; 
try  < 

System. out. println( "start  try"); 
doRisky(test) ; 

System. out. println( "end  try"); 

} catch  ( ScaryException  se)  { 

System. out. println( "scary  exception" ) ; 

} finally  { 

System. out . println( "finally" ) ; 

} 

System. out. println( "end  of  main"); 

} 

static  void  doRisky( String  test)  throws  ScaryException  { 
System.out .println( "start  risky" ) ; 
if  ( "yes". equals (te9t) ) { 

throw  new  ScaryException ( ) ; 

) 

System. out . print In ("end  risky" ) ; 
return; 

} 

} 


Output  when  teat  = "no" 


Output  when  test  = "yes" 


uieujjopua  - Xneuy  - uoiiddDxa  - X>p|jueis  - Xjiueis  :^$aXv=  isai uayM 

uieuujopua  - X||euy  - Xnpua  - X>|Sy  pua  - Xj)5|j  - Xuueis  :^ouT==  isei  ueyM 
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Pid  we  mention  that  a method  can 
throw  more  than  one  exception? 

A method  can  throw  multiple  exceptions  if  it  dam  well  needs  to.  But 
a method's  declaration  must  declare  all  the  checked  exceptions  it  can 
throw  (although  if  two  or  more  exceptions  have  a common  superclass,  the 
method  can  declare  just  the  superclass.) 


Catching  multiple  exceptions 

The  compiler  will  make  sure  that  you’ve  handled  all  the  checked  excep- 
tions thrown  by  the  method  you're  calling.  Stack  the  catch  blocks  under 
the  try , one  after  the  other.  Sometimes  the  order  in  which  you  stack  the 
catch  blocks  matters,  but  well  get  to  that  a little  later. 


/! 


public  class  Laundry  { 

public  void  doLaundryO  throws  PantsException , 
//  code  that  could  throw  either  exception 


) 


) 


LingerieException 


public  class  Foo  { 


public  void  go()  { 

Laundry  laundry  = new  Laundry?) ; 

try  { 

laundry . doLaundry ( ) ; 

} catch (PantsException 


if  doi-d undry?)  £hro«a  a 
PanttExitption,  i-fc  bnj,  j*  ^ 
Panf dafdh  blodc 


//  recovery  code 

} catch (Linger ieExcept ion  lex) 

//  recovery  code 
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Exceptions  are  polymorphic 

Exceptions  are  objects,  remember.  There's  nothing  all  that 
special  about  one,  except  that  it  is  a thing  that  can  be  thrown. 

So  like  all  good  objects,  Exceptions  can  be  referred  to 
polymorphicaby.  A LingerieException  object,  for  example, 
could  be  assigned  to  a ClothingException  reference.  A 
PantsExcepdon  could  be  assigned  to  an  Exception  reference. 
You  get  the  idea.  The  benefit  for  exceptions  is  that  a method 
doesn't  have  to  explicitly  declare  every  possible  exception  it 
might  throw;  it  can  declare  a superclass  of  the  exceptions. 
Same  thing  with  catch  blocks — you  don't  have  to  write  a catch 
for  each  possible  exception  as  long  as  the  catch  (or  catches) 
you  have  can  handle  any  exception  thrown. 


You  can  DECLARE  exceptions  using 
a supertype  of  the  exceptions  you 
throw. 


public  void  doLaundryO 


throws  ClothingException  { 

t 

ar"i  ^7^ leis  you 

L,nier'lt£*CiU\em  T r. 

3nj 

Wivid^jiy  *‘&ou{  explietliy 


All  er*cfb<** 
svyertl^ss’ 


10  Exception 

CiothlngExcdptfon 

. 

Pants£xc^*lon 

Lhfiifli&miflDfl 

ShlrtExctption 

!L 

1 



7i#SN*E»»(itton 

' j i KV  I 

‘f 

@ You  can  CATCH  exceptions  using  a 
supertype  of  the  exception  thrown. 


try  { 

laundry , doLaundr y ( ) ; 


3,-lh  ■ 

} catch (ClothingException  cex)  { 


II  recovery  code 


try  ( 


^ >f 

SSS5»- 


laundry . doLaundry  O ; J 

;,ih  * 

} catch (Shir tException  sax)  { 

//  recovery  code 
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Just  because  you  CAN  catch  everything 
with  one  big  super  polymorphic  catch, 
doesn’t  always  mean  you  SHOULD. 

You  could  write  your  exception-handling  code  so  that 
you  specify  only  one  catch  block,  using  the  supertype 
Exception  in  the  catch  clause,  so  that  you’ll  be  able  to 
catch  any  exception  that  might  be  thrown. 


try  { 

laundry . doLaundry ( ) ; 

} catch (Exception  ex)  { 

//  recovery  code...^ 

} 


I wMT?Ttet^kbWk”" 


Write  a different  catch  block  for  each 
exception  that  you  need  to  handle 
uniquely. 

For  example,  if  your  code  deals  with  (or  recovers 
from)  a TeeShirtException  differently  than  it  handles  a 
LingerieException,  write  a catch  block  for  each.  But  if  you 
treat  all  other  types  of  ClothingException  in  the  same  way, 
then  add  a ClothingException  catch  to  handle  the  rest. 


try  { 

laundry . doLaundry ( ) ; 


} catch  (TeeShirtException  tex)  { 

//  recovery  from  TeeShirtException 


) catch  (LingerieException  lex)  { 

//  recovery  from  LingerieException 


/fWf 

m 


} catch (ClothingException  cex)  { 

//  recovery  from  all  others 

} 


^ons 
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order  of  multiple  catch  blocks 


Multiple  catch  blocks  must  be  ordered 
from  smallest  to  biggest 


catch (TeaShirtException  tax) 


catch (ShirtException  sax) 


PifrtfcEjxtpttai 

] UngritExotftffen  L 

| ttilfl&uaptfon  k 

| UnffonflCxctprion  k 

L. 

■ 

rj  | 

■Ml 

TwSWrtBus^den  L 

1 

on 

1 

ilk  1 

4Lj^  | 

catch (ClothingException  cax) 


The  higher  up  the  inheritance  tree,  the  bigger  the 
catch  "basket*.  As  you  move  down  the  inheritance 
tree,  toward  more  and  more  specialized  Exception 
classes,  the  catch  "basket"  is  smaller.  Itis  just  plain  old 
polymorphism. 

A ShirtException  catch  is  big  enough  to  take 
a TeeShirtException  or  a DressShirtException 
(and  any  future  subclass  of  anything  that  extends 
ShirtException).  A ClothingException  is  even  bigger 
(i.e.  there  are  more  things  that  can  be  referenced 
using  a ClothingException  type).  It  can  take  an 
exception  of  type  ClothingException  (duh) , and 
any  ClothingException  subclasses:  PantsException, 
UnifonmException,  LingerieException,  and 
ShirtException.  The  mother  of  all  catch  arguments 
is  type  Exception;  it  will  catch  any  exception, 
including  runtime  (unchecked)  exceptions,  so  you 
probably  won't  use  it  outside  of  testing. 
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You  can't  pot  bigger  baskets 
above  smaller  baskets. 


Well,  you  cam  but  it  won’t  compile.  Catch 
blocks  are  not  like  overloaded  methods 
where  the  best  match  is  picked.  With  catch 
blocks,  theJVM  simply  starts  at  the  first  one 
and  works  its  way  down  until  it  finds  a catch 
that’s  broad  enough  (in  other  words,  high 
enough  on  the  inheritance  tree)  to  handJe 
the  exception.  If  your  first  catch  block  is 
catch  (Exception  ex) , the  compiler 
knows  there’s  no  point  in  adding  any 
others — they’ll  never  be  reached. 


) catch (ClothingException  cex)  { 

//  recovery  from  ClothingException 


) catch  (LingeriaExeaption  lex)  { 

II  recovery  from  LingerieException 


) catch  (ShirtException  sex)  ( 

i i recovery  from  ShirtException 

) 


Siblings  can  be  in  any  order,  because  they 
can’t  cat cb  one  another's  exceptions. 

You  could  put  ShirtException  above 
LingerieException  and  nobody  would  mind 
Because  even  though  ShirtException  is  a bigger 
(broader)  type  because  It  can  catch  other  classes 
(its  own  subclasses),  ShirtException  canJt  catch  a 
LingerieException  so  there's  no  problem. 
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Assume  the  try/catch  block  here  is  legally  coded. Your  task  is  to  draw 
two  different  class  diagrams  that  can  accurately  reflect  the  Exception 
classes. in  other  words,  what  class  Inheritance  structures  would  make  the 
try/catch  blocks  in  the  sample  code  legal? 

try  { 

x.doRisky 0 ; 

) catch (AlphaEx  a)  { 

//  recovery  from  AlphaEx 
) catch (BataEx  b)  { 

//  recovery  from  BetaEx 
) catah (GammaEx  c)  { 

//  recovery  from  GammaEx 
} catch  (DeltaEx  d)  { 

//  recovery  from  DeltaEx 

) 


BazEjc 


T 


Your  task  is  to  create  two  different  legal  try  /catch  structures  (similar  to 
the  one  above  left),  to  accurately  represent  the  class  diagram  shown  on 
the  left  Assume  ALL  of  these  exceptions  might  be  thrown  by  the  method 
with  the  try  block. 
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When  you  don't  want  to  handle 
an  exception... 


just  duck 


If  you  don’t  want  to  handle  an 
exception,  you  can  duck  it  by 
declaring  it. 

When  you  call  a risky  method,  the  compiler 
needs  you  to  acknowledge  it.  Most  of  the  time, 
that  means  wrapping  the  risky  call  in  a try/ 
catch.  But  you  have  anod^er  alternative,  simply 
duck  it  and  let  the  method  that  called  you  catch 
the  exception. 

It’s  easy — all  you  have  to  do  is  declare  that 
you  throw  the  excepdons.  Even  though, 
technically,  you  aren't  die  one  doing  the 
throwing,  it  doesn't  matter.  You're  still  the  one 
Setting  the  exception  whiz  right  on  by 

But  if  you  duck  an  exception,  then  you  don't 
have  a try/ catch,  so  what  happens  when  the 
risky  method  (doLaundryO)  does  throw  the 
exception? 

When  a method  dirows  an  exception,  that 
method  is  popped  off  the  stack  immediately, 
and  the  exception  is  thrown  to  the  next 
method  down  die  stack- — the  caller.  But  if  the 
caller  is  a ducker ; then  there's  no  catch  for  it  so 
the  caller  pops  off  the  stack  immediately,  and 
the  exception  is  thrown  to  die  next  method 
and  so  on,.,  where  does  it  end?  You'll  see  a 
littie  later. 


public  void  foo()  throws  Real lyBadExcept ion 
//  call  risky  method  without  a try/catch 
laundry . doLaundry ( ) ; 

} 
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handle  or  declare 


Ducking  (by  declaring)  only 
delays  the  inevitable 


Sooner  or  later,  somebody  has  to 
deal  with  it.  But  what  if  maSn() 
ducks  the  exception? 

public  class  Washer  { 

Laundry  laundry  = new  Laundry (]; 

public  void  foot)  throws  ClothingException 
laundry. doLaundry () ; 

) 


public  static  void  main  (String!]  args)  throws  ClothingException  ( 
Washer  a = new  Washer (); 
a . f oo ( ) ; 

> 

) 


OdoLaundryO  throws  o 
ClothingException 


main()  calls  foo() 

foo()  calls  doLaundryO 

doLaundryO  is 
running  and  throws  a 
ClothingException 


®fooO  ducks  the 
exception 


©moinO  ducks  the  The  JVM 

exception  shuts  down 


doLoundry()  pops  off  the 
stack  immediately  and 
the  exception  is  thrown 
back  to  foo(). 

But  f ooO  doesn't  have  a 
try/catch,  so... 


foo()  pops  off  the 
stack  immediately  and 
the  exception  is  thrown 
back  to...  who?  What? 
There's  nobody  left 
but  the  JVM,  and  it's 
thinking,  “Don't  expect 
ME  to  get  you  out  of 
this." 


We’re  using  the  tee-shirt  to  represent  a Clothing 
Exception.  We  know,  we  know...  you  would 
have  preferred  the  blue  jeans. 
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Handle  or  Declare.  It’s  the  law. 

So  now  we've  seen  both  ways  to  satisfy  the  compiler 
when  you  call  a risky  (exception-throwing)  method. 


# HANDLE 

Wrap  the  risky  call  in  a try/catch 
try  { 

laundry . doLaundry ( ) ; 

} catch (ClothingException  cex)  { 

//  recovery  code 

} 


throw.  Or  e|„  1l.  , ..  ' \ 

°*  the  exceptions. 


Catching  a|| 


DECLARE  (duck  it) 

Declare  that  YOUR  method  throws  the  same  exceptions 


as  the  risky  method  you're  calling. 

void  f oo  ( ) throws  ClothingException  { 

laundry . doLaundry  ( ) ; 

} 


Tte 


***** 


Ho  by«uv 


But  now  this  means  that  whoever  calls  the  foo()  method 
has  to  follow  the  Handle  or  Declare  law.  If  fooQ  ducks 
the  exception  (by  declaring  it),  and  main()  calls  foo(),  then 
mainQ  has  to  deal  with  the  exception. 


public  class  Washer  { 

Laundry  laundry  = new  Laundry (); 


public  void  foo()  throws  ClothingException  { 


laundry .doLaundry () ; 


} 


public  static  void  main  (String []  args)  { 
Washer  a = new  Washer (); 


} 


a . foo  ()  ; 

• tt'wii  by  doLaundryO 

'•‘JinO  has  wrap  a foot)  • , i , , 1 

~ v n L , P w;  "*  a ^y/eatch, 

-a^Ohas  to  declare  that  it,  too, 
throws  ClothingException/ 


trouBlbh 

eitte^- 
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fixing  the  Sequencer  code 


Getting  back  to  our  music  code 


Now  that  you've  completely  forgotten,  we  started  this  chapter 
with  a first  look  at  some  JavaSound  code.  We  created  a Se- 
quencer object  but  it  wouldn't  compile  because  the  method 
Midi.getSequencer()  declares  a checked  exception  (MidiUnavail- 
ableException).  But  we  can  fix  that  now  by  wrapping  the  call  in  a 
try/ catch. 

public  void  playO  { 

try  { 


Sequencer  sequencer  = MidiSystem. getSequencer () ; 
System. out. println ("Successfully  got  a sequencer"); 


The 


} catch (MidiUnavailableException 


System. out. println ("Bummer") ; 


CaJ-tL/r- . ir 


> 


*Wcf 


} //  close  play 


Exception  Rules 


^ *°W</  i „ 

ftsiiL,.  , have  I h*v'a 
9 ^^ihe 


You  cannot  have  a catch  or  finally 
without  a try 

void  go  ( ) { |^0f  ? 

Foo  f = new  Foo(); 
f .foof () ; 

catch (FooException  ex)  { } 

} 


Q A try  MUST  be  followed  by  either  a 
catch  or  a finally 

try  { feve  a you 

x . dostuf  f ( ) ; ^ T ^ 

} finally  < ^ 

//cleanup  ^ fc'  U,  , 


You  cannot  put  code  between  the 
try  and  the  catch 

N0TlE4AU  yt 


try  { 


£ode  h+i  ’ f w pux 

int  y = 43; 

} catch (Exception  ex)  { } 


^ A try  with  only  a finally  (no  catch) 
must  still  declare  the  exception. 

void  go()  throws  FooException  { 

try  { •iw»UtaUV' 

x. doStuf f ( ) ; A Vf  , iw 

) finally  { ) ^ J ^ 

> ****** 
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Code  Kitche 


There  is  NO  way 
I'm  letting  Betty  win  the 
code-off  this  year,  so  Vm 
gonna  make  it  myself  from 
l scratch. 


Tbe  rest  of  this  chapter 
is  optional;  you  can  use 
Ready-bake  code  Jor  all 
tbe  music  apps. 

But  i{  you  want  to  learn 
more  aLout  JavaSoimd, 
turn  tlie  page. 


vJ 

r 

,<L, 

1 ^ 

f - PH 

W/ 11 

L~' 
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Pi  ' "* 

Mg 

.Vn  v V — ■ 

re..,.-  - --  .-^v^ 
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JavaSound  MIDI  classes 


Making  actual  sound 

Remember  near  the  beginning  of  the  chapter,  we  looked  at  how  MIDI  data  holds 
the  instructions  For  what  should  be  played  (and  how  it  should  be  played)  and  we 
also  said  that  MIDI  data  doesn’t  actually  create  any  sound  that  you  hear.  For  sound 
to  come  out  of  the  speakers,  the  MIDI  data  has  to  be  sent  through  some  kind  of 
MIDI  device  that  takes  the  MIDI  instructions  and  renders  them  in  sound,  either 
by  triggering  a hardware  instrument  or  a ‘virtual’  instrument  (software  synthe- 
sizer). In  this  book,  we’re  using  only  software  devices,  so  here’s  how  it  works  in 
JavaSound: 


You  need  FOUR  things: 


(T)  The  thing  that 
plays  the  music 


The  music  to  be 
played... a song. 


The  part  of  the 
Sequence  that 
holds  the  actual 
Information 


The  actual  music 
information: 
notes  to  play, 
how  long,  etc. 


The  Sequencer  Is  the  thing 
that  actually  causes  a song 
to  be  played.Thlnk  of  It  like 

a music  CD  player. 


has  a 

Sequence  ► Track 


The  Sequence  is  the 
song,  the  musical  piece 
that  the  Sequencer  will 
play.  For  this  book,  think 
of  the  Sequence  as  a 
music  CD,  but  the  whole 
CD  plays  just  one  song. 


For  this  book,  we  only 
need  one  Track,  so  Just 
Imagine  a a music  CD 
with  only  one  song.  A 
singleTrack. This  Track 
Is  where  all  the  song 
data  {MIDI  information) 
lives. 


A MIDI  event  is  a message 
that  the  Sequencer  can 
understands  MIDI  event 
might  say  (if  It  spoke 
English), "At  this  moment 
In  time,  play  middle  C,  play 
It  this  fast  and  this  hard, 
and  hold  It  for  this  long." 

A MIDI  event  might 
also  say  something  like, 
"Change  the  current 
instrument  to  Flute/ 
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And  you  need  FIVE  steps; 

^ Get  a Sequencer  and  open  it 

Sequencer  player  = KidiSystem.getSequencer () ; 
player .open () ; 


@ Make  a new  Sequence 

Sequence  seq  - new  Sequence (timing,  4); 


^ Set  a new  Track  from  the  Sequence 

Track  t = seq. createTrack () ; 


Fill  the  Track  with  MidiEvents  and 
give  the  Sequence  to  the  Sequencer 
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Your  very  first  sound  player  app 

Type  it  in  and  run  it.  You’ll  hear  the  sound  of  someone  playing  a 
single  note  on  a piano!  (OK,  maybe  not  some^  but  something.) 


import  javax. sound. midi.*; 


public  class  MiniMiniMusicApp  { 


public  static  void  main (String [ ] args)  { 

MiniMiniMusicApp  mini  = new  MiniMiniMusicApp () ; 
mini .play ( ) ; 


} //  close  main 

public  void  play()  { 
try  { 

HH  Sequencer  player  = MidiSystem . getSequencer () ; 
player .open () ; 


Iso'tte 

dot*" 


y a*# 
t a* 


•A****  «se  * 


\ to**1 


* 

***** 


Sequence  seq  - new  Sequence (Sequence . PPQ,  4); 


Track  track  = seq. createTrack () ; 


^ShortMessage  a = new  ShortMessage ( ) ; s 
a. setMessage (144,  1,  44,  100); 

MidiEvent  noteOn  = new  MidiEvent(a,  1) ; 
track. add (noteOn) ; 


ShortMessage  b - new  ShortMessage () ; 
b. setMessage (128,  1,  44,  100); 
MidiEvent  noteOff  = new  MidiEvent (b, 
track. add (noteOff) ; 


lives  in  the  Tral  **  ^ ^ ^ 


Put  some  MidiEvents  into  the  Trick.  This  part 
« -ostly  Keady-bake  Code.  The  only  thin-  you'll 
have  to  eare  about  are  the  agents  to  the 
setA'IessajeO  method,  and  the  agents  to 
the  MdiEvent  tonsWtor.  IVe'll  look  at  those 
arguments  on  the  next  pa<je 


} 


player . setSequence  (seq) ; ^ ^ ^ ^ ^ ^ 

player. start  () ; ^ putting  the  CP  in  the  CP  player) 

^tartO  th.  c 

{ e d k 

e PL^) 


} catch  (Exception  ex) 

ex.printStackTrace ()  ; 

} 


} //  close  play 
//  close  class 
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Making  a MidiEvent  (song  data) 

A MidiEvent  is  an  instruction  for  part  of  a song.  A series  of  MidiEvents  is 
kind  of  like  sheet  music,  or  a player  piano  roll.  Most  of  the  MidiEvents  we 
care  about  describe  a iking  to  do  and  the  moment  in  time  to  do  it  The  moment 
in  time  part  matters,  since  timing  is  everything  in  music.  This  note  follows 
this  note  and  so  on.  And  because  MidiEvents  are  so  detailed,  you  have  to  say 
at  what  moment  to  replaying  the  note  (a  NOTE  ON  event)  and  at  what 
moment  to  stop  playing  the  notes  (NOTE  OFF  event).  So  you  can  imagine 
that  firing  the  “stop  playing  note  G1’  (NOTE  OFF  message)  before  the  “start 
playing  Note  G”  (NOTE  ON)  message  wouldn’t  work. 

The  MIDI  instruction  actually  goes  into  a Message  object;  the  MidiEvent  is 
a combination  of  the  Message  plus  the  moment  in  time  when  that  message 
should  'fire'.  In  other  words,  the  Message  might  say,  “Start  playing  Middle 
Cn  while  the  MidiEvent  would  say,  “Trigger  this  message  at  beat  4rt. 

So  we  always  need  a Message  and  a MidiEvent. 

The  Message  says  what  to  do,  and  the  MidiEvent  says  when  to  do  it. 


£ Make  a Message 

ShortMessage  a = new  ShortMessage  () ; 


A MidiEvent  says 
what  to  do  and 
when  to  dojtr  "" 

Every  instruction 
must  include  the 


timing  for  that 


instruction. 


In  other  words,  at 
which  heat  that 
thing  should  happen. 


Put  the  Instruction  in  the  Message 

a . setMessage (144,  1,  44,  100); 

Make  a new  MidiEvent  using  the  Message 

MidiEvent  noteOn  = new  MidiEvent (a,  1), 

/Add  the  MidiEvent  to  the  Track 

track . add (noteOn) . 


rv.  ^ ws  or,  V* 

^ M tt<  **- 

,l“u  ^ *9S«d. 


I LL  * SdTnt  mOtTvCTV  L TJ 

^ ***  ^ ^ s;  a rriL  We 
LwLb  ^ * tte  ^ 
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contents  of  a Midi  event 


MIPI  message:  the  heart  of  a MidiEvent 

A MIDI  message  holds  the  part  of  the  event  that  says  what  to  do.  The  actual  instruction 
you  want  the  sequencer  to  execute.  The  first  argument  of  an  instruction  is  always  the  type 
of  the  message.The  values  you  pass  to  the  other  three  arguments  depend  on  the  type  of 
message.  For  example!  a message  of  type  144  means  “NOTE  OhT.  But  in  order  to  carry 
out  a NOTE  ON>  the  sequencer  needs  to  know  a few  things^Imagine  the  sequencer  saying, 
“OK,  HI  play  a note,  but  which  channel ? In  other  words,  dp' you  want  me  to  play  a Drum 
note  or  a Piano  note?  And  which  note?  Middle-C?  D Sharf#  And  while  weTe  at  it,  at  which 
velocity  should  1 play  the  note?  \ 

To  make  a MIDI  message,  make  aShortMessage  instance  and  invoke  setMessage(),  passing 
in  the  four  arguments  for  the  message.  But  remember,  the  message  says  only  what  to  do,  so 
you  still  need  to  stuff  the  message  into  an  event  that  adds  when  that  message  should  ‘fire'. 


Anatomy  of  a message 

The  first  argument  to  setMessage()  always 
represents  the  message  'type',  while  the  other 
three  arguments  represent  different  things 
depending  on  the  message  type, 


f""'  **  ite  u J*.  , ««3<.  *o 

tnow  » «fd»  I* 


NOTE  OFF 


Message  type 


144  means 
NOTE  ON 


128  means 


The  Message  says  what  to  do,  the 
MidiEvent  says  when  to  do  it 


$ Channel 

Think  of  a channel  like  a musician  in 
a band.  Channel  1 is  musician  1 (the 
keyboard  player),  channel  9 is  the 
drummer,  etc. 


£ Note  to  play 


A number  from  0 to  127,  going 
from  low  to  high  notes. 


£ Velocity 

How  fast  and  hard 
you  press  the  key?  0 is  so  soft  you 
probobly  won't  hear  anything,  but  100  is  a 
good  default. 
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Change  a message 

Now  that  you  know  what’s  in  a Midi  message,  you  can  start  experimenting.  You 
can  change  the  note  that’s  played,  how  long  the  note  is  held,  add  more  notes, 
and  even  change  the  instrument. 

Q Change  the  note 

Try  a number  between  0 and  127  in  the  note 
on  and  note  off  messages. 

a. setMessage  (144,  1,  20,  100); 


^ Change  the  duration  of  the  note 

Change  the  note  off  event  (not  the  message)  so 
that  it  happens  at  an  earlier  or  later  beat. 

b. setMessage (128,  1,  44,  100); 
MidiEvent  noteOff  = new  MidiEvent (b,  3 


£ Change  the  instrument 

/Add  a new  message,  BEFORE  the  note-playing  message, 
that  sets  the  instrument  in  channel  1 to  something  other 
than  the  default  piano.  The  change-instrument  message 
is  '192',  and  the  third  argument  represents  the  actual 
instrument  (try  a number  between  0 and  127) 

first . setMessage  (192,  1,  102,  0)  ; 


you  are  here  ► 345 


change  the  instrument  and  note 


Version  2:  Using  command-line  args  to  experiment  with  sounds 


This  version  still  plays  just  a single  note,  but  you  get  to  use  command-line  argu- 
ments to  change  the  instrument  and  note.  Experiment  by  passing  in  two  int  values 
From  0 to  127.  The  first  int  sets  the  instrument,  the  second  int  sets  the  note  to  play. 


import  javax. sound .midi. *; 


public  class  MiniMusicCmdLine  { //  this/ls  the  first  one 

public  static  void  main  (String  [)  args!)  { 

MiniMusicCmdLine  mini  = new  MiniMusicCmdLine 0 ; 
if  (args. length  < 2)  { 

System. out .println ("Don' t forget  the  instrument  and  note  args") ; 
) else  { 

int  instrument  = Integer . parselnt (args [ 0 ]) ; 
int  note  = Integer .parselnt (args (1) ) ; 
mini .play (instrument , note); 


) 

} I!  close  main 


public  void  play (int  instrument,  int  note)  { 
try  { 

Sequencer  player  = MidiSystem. getSequencer () ; 
player .open () ; 

Sequence  seq  = new  Sequence (Sequence  - PPQ,  4) ; 
Track  track  = seq. createTrack  () ; 

MidiEvent  event  = null; 


ShortMessage  first  = new  ShortMessage  ( ) ; 
first . setMessage  (1P2,  1 , instrument,  0) ; 

MidiEvent  changelnstrument  = new  MidiEvent  (first,  1); 
track . add (changelnstrument) ; 

ShortMessage  a = new  ShortMessage 0 ; 

a .  setMessage (144 , l,  note,  100); 

MidiEvent  noteOn  = new  MidiEvent (a,  1) ; 
track . add (noteOn } ; 

ShortMessage  b = new  ShortMessage () ; 

b.  setMessage (128,  1,  note,  100) ; 

MidiEvent  noteOff  = new  MidiEvent  (b,  16); 
track. add (noteOff) ; 
player . setSequence (seq)  ; 
player. start ()  ; 

) catch  (Exception  ex)  { ex . printStackTrace ( ) ; ) 

( //  close  play 
) //  close  class 


Ruri  rt  witk  ■two  ink  dry  -frow  O 

bo  12-7.  Try  t)vcse  (or  rbrUrt 


| File  Edit 

Wfndow  Help  Allenusle 

% java 

MiniMusicCmdLine 

102 

30 

% java 

MiniMusicCmdLine 

80 

20 

% java 

MiniMusicCmdLine 

40 

70 
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Where  weYe  headed  with  the  rest 
of  the  CodeKitchens 


Chapter  15:  the  goal 

When  were  done,  we’ff  have  a working 
BeatBox  that's  also  a Drum  Chat  Client. 
Well  need  to  learn  about  GUIs  (includ- 
ing event  handling),  I/O,  networking,  and 
threads.  The  next  three  chapters  (12, 13, 
and  14)  will  get  us  there. 


~~  Cyfeif  iwtlpx 

Sue  Drum  0_  G G‘SS_  _J0G  ^ „BGG  _ 
□otfDQSlSlSOOlfDODfijS 

owflw-H*  □oaaQoaacooooGDD 
Mow*  &«t  □ OG  O Q O O GG  □ □ DO  □ D B 
craiMVtttuf  □OODDOODDOSESDCD 
Hwicup  ^eaOQDGaOGGGDDDGa 
._j^_:_J^_jQQOQQQQQC 
rtJjdSoc  OGODQDDODOaOtftfao 

Mir mu 

*****  QOQQeaEteaaeaQeGo 
Uco«**  □GQQCGl3G^0«Gtf0QG 
Ccmtwti  □daDDQaODOQODQQG 
vibruu*  QOG  DOQQOQ0QOGQGG 
^ q OOQ  GGO  G □ 03  0000  0 
DODGacaOQGGGOGGO 
opwwc«9C)GQtf0«GOQCGGtf0«G 


GE*3 

C^D 

r twipoup  > 


Chris:  ^mv«2  rtvfetd 
W^drabsit 


Chapter  12:  MIDI  events 

This  CodeKitchen  lets  us  build  a little 
'‘music  video"  (bit  of  a stretch  to  call  it 
that...)  that  draws  random  rectangles  to 
the  beat  of  the  MIDI  music.  Well  learn 
how  to  construct  and  play  a lot  of  MIDI 
events  (instead  of  just  a couple,  as  we  do 
in  the  current  chapter). 


Chapter  13:  Stand-alone 
BeatBox 

Now  well  actually  build  the  real  BeatBox, 
GUI  and  all.  But  it's  Jimited'-as  Soon  as  you 
change  a pattern,  the  previous  one  is  lost. 
There's  no  Save  and  Restore  feature,  and 
it  doesn’t  communicate  with  the  network. 
(But  you  can  still  use  it  to  work  on  your 
drum  pattern  skills.) 


: flG0Q0*oaoGf 

omm  >ti-m  □ □ flee  oG&a  e 000  * g of 

oetnMt-HM  ODQ0DGGQOQOOQQBO, 

<*«□ 000000000  0 □ e □ □ i r 

omihCwt  QOBSOOOOBPQPOOOQ^ 

HMd dip  go 

1 ni®h  t»«  Bjwd-jC'-^L' 

: OOGQGQODDOOOOGGt? 

-:.1 «---- 


whuu*  C _ G _ U. .-u.  _ □GGOOO 

GGBPGPGOOQQaOOOO 
c«**«  G CBDOGGG  JMsL 
*****  OP  □ PPPPC  u P B P G G G G 

gddpgogopggpggbg 

*¥W 

Ow*  w £-»C  GOQQO0000OGO90O 


Chapter  14:  Save  and 
Restore 

You've  made  the  perfect  pattern,  and 
now  you  can  save  it  to  a file,  and  reload  it 
when  you  want  to  play  it  again.  This  gets 
us  ready  for  the  final  version  (chapter  15), 
where  instead  of  writing  the  pattern  to  a 
file,  we  send  it  over  a network  to  the  chat 
server. 


'oca 


•mow*  □OBPOOBOQBGtfQGBOi 
Ctoudw-rt*  0 0B  jGGQDOOGQDS DQ| 

:©p*hi-k*  DGGODQDGOOeOOGBO 
1 ^i^QQQseaeeoQOQOOQOf—^ 
crnKCyi**  ~^*^rifnnriitiriFtrat3riririPW^q#»J  | 

K«d  040 
Miflh  Tam 


«WMk 


G 0 PQ  G DOGDO □ □ DOG  P C 
BaCPPGGPQGOGQOQOi' 
Q00DGODGGPGDGGGG 

G-S: . 

□□□□PpCCJGLjGGDGG 
G 0 O O ODBC.1 0 0 C G C - - - 
CDlSQGOQLSW'J-i- 
DO  GOP  PPG-  G BO  GG  Q G 
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you  are  here  ► 347 


This  chapter  explored  the  wonderful  world  of 
exceptions.  Your  job  is  to  decide  whether  each  of  the 
following  exception-related  statements  is  true  or  false. 


or  Fatses 

1.  A try  block  must  be  followed  by  a catch  Ltd  a finally  block. 

2.  If  you  write  a method  that  might  cause  a compiler-checked  exception,  you 
must  wrap  that  risky  code  in  a try  / catch  block. 

3.  Catch  blocks  can  be  polymorphic. 

4.  Only  ‘compiler  checked’  exceptions  can  be  caught 

5.  If  you  define  a try  / catch  block,  a matching  finally  block  is  optional. 

6.  If  you  define  a try  block,  you  can  pair  it  with  a matching  catch  or  finally  block, 
or  both. 

7.  If  you  write  a method  that  declares  that  it  can  throw  a compiler-checked  ex- 
ception, you  must  also  wrap  the  exception  throwing  code  in  a try  / catch  block. 

8.  The  main( ) method  in  your  program  must  handle  all  unhandled  exceptions 
thrown  to  it. 

9.  A single  try  block  can  have  many  different  catch  blocks. 

10.  A method  can  only  throw  one  kind  of  exception. 

11.  A finally  block  will  run  regardless  of  whether  an  exception  is  thrown. 

12.  A finally  block  can  exist  without  a try  block. 

13.  A try  block  can  exist  by  itself,  without  a catch  block  or  a finally  block. 

14.  Handling  an  exception  is  sometimes  referred  to  as  ‘ducking’. 

15.  Tire  order  of  catch  blocks  never  matters. 

16.  A method  with  a try  block  and  a finally  block,  can  optionally  declare  the 
exception. 

17.  Runtime  exceptions  must  be  handled  or  declared. 
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RetSe 


Fie  Em  Window  Mp  ThfwUp 


* java  ExTestDrive  yes 
thaws 

? java  ExTestDrive  no 
throws 


Code  Magnets 


A working  Java  program  is  scrambled  up  on  the  fridge.  Can  you 
reconstruct  all  the  code  snippets  to  make  a working  Java  program 
that  produces  the  output  listed  below?  Some  of  the  curly  braces  fell 
on  the  floor  and  they  were  too  small  to  pick  up,  so  feel  free  to  add  as 
many  of  those  as  you  need! 


Systenwout .printing's" ) ; 

| > finally 

-J 

^ystesuout* print (V) ; 

r 

class  My Ex  extends  Exception  { } 
public  class  ExTestDrive  { 


static  void  doRisky( String  t)  throws  My Ex  { 
System* out  * print  ( "hJ' ) ; 
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puzzle:  crossword 


Yo  u know  what  to  do ! 


Across 

1 . To  give  value 
4.  Flew  off  the  top 
6.  All  this  and  more! 
8.  Start 

10,  The  family  tree 
13.  Noducklng 
1 5.  Problem  objects 
18.  One  of  Java's  '49* 


20.  Class  hierarchy 

21.  Too  hot  to  handle 

24.  Common  primitive 

25.  Code  recipe 

27.  Unruly  method  action 

28.  No  Picasso  here 

29.  Start  a chain  of  events 


Down 

2 Currently  usable 

3.  Template's  creation 

4.  Dont  show  the  kids 

5.  Mostly  static  API  class 

7.  Not  about  behavior 

9.  The  template 

1 1 . Roll  another  one  off 
the  line 


12.  Javac  saw  it  coming 
14.  Attempt  risk 

16.  Automatic  acquisition 

17.  Changing  method 
19.  Announce  a duck 

22.  Deal  with  rt 

23.  Create  bad  news 

26.  One  of  my  roles 


More  Hints:  -siaqumN  S 

eioM  7i  (3|duiexaiou)  joj'J 

aunuoj  4[UJSj  dip  *9 1 qreMijinouj  p jo  Z 

i|0Ej3p  jo  3j(qnd  Xfuo  ‘6  umoq 


UdUqvW n mSZ 
uiaiqoid  eujeis  'Ll 
ipenfc  -i z 

U0[iX)(J03  JO  ddXl  B OSJV  '0Z 


ajepapjo  pp^ui 
poLjidcu  e ueis  -Q 
PHipeACfv  *9 
woy 
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Exercise-  Solutions 


V 

fwcn  Fa.se 

1 . False,  either  or  both. 

2.  False,  you  can  declare  the  exception. 

3.  True. 

4.  False,  runtime  exception  can  be  caught. 

5.  True. 

6.  True,  both  are  acceptable. 

7.  False,  the  declaration  is  sufficient. 

8.  False,  but  if  it  doesn't  the  JVM  may  shut 
down. 

9.  True. 

10.  False. 

11.  TVue.  It's  often  used  to  clean-up  partially 
completed  tasks. 

12.  False. 

13.  False. 

14.  False,  ducking  is  synonomous  with  declar- 
ing. 

15.  False,  broadest  exceptions  must  be  caught 
by  the  last  catch  blocks. 

16.  False,  if  you  don't  have  a catch  block,  you 
must  declare. 

17.  False, 


Code  Magnets 

class  My Ex  extends  Exception  { > 

public  class  ExTestDrive  { 

public  static  void  main (String  [ 5 args)  { 
String  test  = args[0j; 
try  { 

System. out . print ( " t" ) ; 
doRisky( test) ; 

System, out. print ( ; 

> catch  ( MyEx  e)  { 

System. out. print ("a" ) ; 

> finally  { 

System, out- print ( "w" ) ; 

> 

System.out.println("sw) ; 


static  void  doRisky (String  t)  throws  MyEx  { 
System. out. print ("h" ) ; 

if  ("yes" .equals(t) ) { 

throw  new  MyEx(); 

> 

System. out. print( "r")  j 


} Fife  £*t  Wndw  Hatp  Chi 


3 java  ExTestDrive  yes 
thaws 

\ java  ExTestDrive  no 
throws 


you  are  here  > 351 


puzzle  answers 


Ja\aCr«ss  Answers 
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Wow]  This  looks  greet 
X guess  presentation 
redly  is  everything. 


I heard  your 
ex-wife  could  only  cook 
command-line  meals. 


Face  it,  you  need  to  make  GUIs.  If  you're  building  applications  that  other 
people  are  going  to  use,  you  need  a graphical  interface.  If  you're  building  programs  for  yourself, 
you  want  a graphical  interface.  Even  if  you  believe  that  the  rest  of  your  natural  life  will  be 
spent  writing  server-side  code,  where  the  client  user  interface  1$  a web  page,  sooner  or  later 
you'll  need  to  write  tools, and  you'll  want  a graphical  interface.  Sure,  command-line  apps  are 
retro,  but  not  in  a good  way.They're  weak,  inflexible, and  unfriendly.  Well  spend  two  chapters 
working  on  GUIs, and  learn  key  Java  language  features  along  the  way  Including  Event 
Handling  and  Inner  Classes.  In  this  chapter,  we'll  put  a button  on  the  screen,  and  make  it  do 
something  when  you  click  It.  We'll  paint  on  the  screen,  we'll  display  a jpeg  image, and  we'll  even 
do  some  animation. 
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your  first  gui 


It  all  starts  with  a window 

AJFrame  is  the  object  that  represents 
a window  on  the  screen.  It's  where  you 
put  all  the  interface  things  like  buttons, 
checkboxes,  text  fields,  and  so  on.  It  can 
have  an  honest-to-goodness  menu  bar 
with  menu  items.  And  it  has  all  the  litde 
windowing  icons  for  whatever  platform 
you're  on,  for  minimizing,  maximizing,  and 
closing  the  window. 

The  JFrame  looks  different  depending  on 
the  platform  you're  on.  This  is  a JFrame  on 
Mac  OS  X: 


“If  I see  one  more 
command-line  app, 
you’re  fired.” 


see 

File  Panic  Deviate 

dfck  me  \ © choose  me 


A 


Put  widgets  in  the  window 


...  a 

(.***» 


Making  a GUI  is  easy: 

^ Make  a frame  (a  JFrame) 

JFrame  frame  - new  JFrame  ()  ; 

@ Make  a widget  (button,  text  field,  etc.) 

JButton  button  = new  JBut ton ("click  me") 


Once  you  have  a JFrame,  you  can  put 
things  (‘widgets’)  in  it  by  adding  them 
to  the  JFrame.  There  are  a ton  of  Swing 
components  you  can  add;  look  for  them 
in  thejavax.swing  package.  The  most 
common  include  JButton,  JRadioButton, 
JCheckBox,JLabel>JUst,JScrollPane, 
JSlider,  JTextArea,  JTextField,  and 
JTable.  Most  are  really  simple  to  use,  bxit 
some  (like  JTable)  can  be  a bit  more 
complicated. 


Add  the  widget  to  the  frame 

frame „ getContentFane ( ) . add (button) 

<Wt  add  tw,s  A A,  l 

tri«,  around  ih(  wih/(  j t"C 


@ bisplay  it  (give  it  a size  and  make  it  visible) 

frame, setSize (300 ,300) ; 
frame . setViaUble (true) ; 
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Your  first  GUI:  a button  on  a frame 

lnport  javax. awing.*; 


public  class  SimpleGuil  { 
public  static  void  main 


(StringH  arga)  { 


j»  > ^ 


ai%A 


a 


JFrame  frame  = new  JFrame  ( ) ; ^ 

JButton  button  = new  JButton  (''click 


C yoa  waat  on  toe 


frame  . setDefaultCloseOperation  ( JFrama  *EXIT_OH_CLOSE)  ; 

&>*  line  walc«j  £K« 


frame  , getCon ten tPane  ()  .add  (button)  ; 
frame . setSiza (300 , 300) ; 


jwt  Ueve  «h  -tKe^-  * ^ ^ *•« 


s^'r«en  forever) 


^ thf  b>^on  io  C , 

^Wpane  +^s 


,ivt  . 

*>)  Piv-/ 

frame . setVisible  (true)  ; ' 

*wlly,  xfe  H ,„,Ut!l  ((  , 


Let’s  see  what  happens  when  we  run  It: 

%java  SimpleGuil 


see 


Whoa!  That7 s a 
Really  Big  Button. 

The  button  fills  oil  the 
available  space  in  the  frame. 
Later  we’ll  learn  to  control 
where  (and  how  big)  the 
button  is  on  the  frame. 
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Put  nothing  happens  when  I click  it... 


That's  not  exactly  true.  When  you  press  the  button  it  shows  that 
‘pressed’  or  ‘pushed  in'  look  (which  changes  depending  on  the 
platform  look  and  feel,  but  it  always  does  something  to  show  when 
it’s  Efeing-pfessed) . 


The  real  question  is,  “How  do  I get  the  button  to  do  something 
specific  when  the  user  clicks  it?” 


We  need  two  things: 

® A method  to  be  called  when  the  user 
clicks  (the  thing  you  want  to  happen  as 
a result  of  the  button  click). 

® A way  to  know  when  to  trigger 
that  method.  In  other  words,  a way 
to  know  when  the  user  clicks  the 
button! 


When  the  user  clicks,  we  want 
to  know. 


We’re  interested  in  the  user- 
takes-action-on-a-button  event. 


Will  a button  look  like  a 


Windows  button  when  you  run  on 
Windows? 


If  you  want  it  to.  You  can 
choose  from  a fewlook  and 
feels"— classes  in  the  core  library 
that  control  what  the  interface  looks 
like.  In  most  cases  you  can  choose 
between  at  least  two  different  looks: 
the  standard  Java  look  and  feel,  also 
known  as  Metal,  and  the  native  look 
and  feel  for  your  platform. The  Mac 
OS  X screens  in  this  book  use  either 
the  OS  X Aqua  look  and  feel,  or  the 
Metal  look  and  feel. 


Q? 


Can  I make  a program  look 
like  Aqua  all  the  time?  Even  when 
It's  running  under  Windows? 


Nope.  Not  all  look  and  feels 
are  available  on  every  platform.  If 
you  want  to  be  safe,  you  can  either 
explicitly  set  the  look  and  feel  to 
Metal,  so  that  you  know  exactly  what 
you  get  regardless  of  where  the  app 
is  running,  or  don't  specify  a look 
and  feel  and  accept  the  defaults. 


I heard  Swing  was  dog-slow 
and  that  nobody  uses  ft. 


This  was  true  fn  the  past 
but  Isn't  a given  anymore.  On  weak 
machines,  you  might  feel  the  pain  of 
Swing.  But  on  the  newer  desktops, 
and  with  Java  version  1 .3  and  be- 
yond, you  might  not  even  notice  the 
difference  between  a Swing  GUI  and 
a native  GUI.  Swing  Is  used  heavily 
today,  in  all  sorts  of  applications. 
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fretting  a user  event 

Imagine  you  want  the  text  on  the  button  to 
change  from  click  me  to  Fve  been  clicked  when 
the  user  presses  the  button.  First  we  can  write  a 
method  that  changeable  text  of  the  button  (a 
quick  looklhrcuign  the  API  will  show  you  the 
method): 


public  void  changelt ()  { 

button . s« tTex t ( " I ' va  bean  clicked!"); 

) 

But  now  what?  How  will  we  know  when  this 
method  should  run?  How  wiU  we  know  when  the 
button  is  clicked? 

In  Java,  the  process  of  getting  and  handling  a 
user  event  is  called  event-handling.  There  are 
many  different  event  types  in  Java,  although 
most  involve  GUI  user  actions.  If  the  user  clicks 
a button,  that's  an  event  An  event  that  says 
The  user  wants  the  action  of  this  button  to 
happen.”  If  it’s  a “Slow  Tempo”  button,  the  user 
wants  the  slow-tempo  action  to  occur.  If  it1*  a 
Send  button  on  a chat  client,  the  user  wants  the 
send-my-message  action  to  happen.  So  the  most 
straightforward  event  is  when  the  user  clicked 
the  button,  indicating  they  want  an  action  to 
occur. 

With  buttons,  you  usually  don't  care  about  any 
intermediate  events  like  button-is-being-pressed 
and  button-is-being-released.  What  you  want  to 
say  to  the  button  is,  “I  don't  care  how  the  user 
plays  with  the  button,  how  long  they  hold  the 
mouse  over  it,  how  many  times  they  change  their 
mind  and  roll  off  before  letting  go,  etc.  Just  ten 
wie  when  the  user  means  business / In  other  words, 
don't  call  me  unless  the  user  clicks  in  a way  that 
indicates  he  wants  the  dam  button  to  do  what  it 
says  it'll  doP 


First,  the  button  needs  to  know 
that  we  care. 


@ TW  wr  tlitfced  «*! 


Second,  the  button  needs  a way 
to  call  us  back  when  a button- 
clicked  event  occurs. 


1)  How  could  you  tell  a button  object  that  you 
care  about  its  events?  That  you're  a concerned 
listener? 


2)  How  will  the  button  call  you  back?  Assume 
that  there's  no  way  for  you  to  tell  the  button  the 
name  of  your  unique  method  (changeltO).  So 
what  else  can  we  use  to  reassure  the  button  that 
we  have  a specific  method  it  can  call  when  the 
event  happens?  [hint:  think  Pet] 
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If  you  care  about  the  button’s  events, 

Ithat  says, 


implement  an  interface 


listening 


Ifor  your  events.” 


A listener  interface  is  the  bridge  between  the 
listener  (you)  and  event  source  (the  button). 

The  Swing  GUI  components  are  event  sources.  In  Java  terms, 
an  event  source  is  an  object  that  can  turn  user  actions  {dick 
a mouse,  type  a key,  close  a window)  into  events*  And  like 
virtually  everything  else  in  Java,  an  event  is  represented  as  an 
object.  An  object  of  some  event  class.  If  you  scan  through  the 
java. awt. event  package  in  the  API,  you'll  see  a bunch  of  event 
classes  (easy  to  spot — they  all  have  Event  in  the  name).  You’ll 
find  MouseEvent,  ReyEvent,  WindowEvent,  ActionEvent,  and 
several  others* 


An  event  source  (like  a button)  creates  an  event  object  when  the 
user  does  something  that  matters  (like  dick  the  button).  Most 
of  the  code  you  write  (and  all  the  code  in  this  book)  will  receive 
events  rather  than  create  events.  In  other  words,  you’ll  spend 
most  of  your  time  as  an  event  listener  rather  than  an  event  source. 

Every  event  type  has  a matching  listener  interface.  If  you  want 
MouseEvents,  implement  the  MouseListener  interface.  Want 
WindowEvents?  Implement  WindowListener.  You  get  the  idea. 
And  remember  your  interface  rules — to  implement  an  interface 
you  declare  that  you  implement  it  (class  Dog  implements  Pet), 
which  means  you  must  write  implementation  methods  for  every 
method  in  the  interface. 


Some  interfaces  have  more  than  one  method  because  the 
event  itself  comes  in  different  flavors.  If  you  implement 
MouseListener,  for  example,  you  can  get  events  for 
mousePressed,  mouseReleased,  mouseMoved,  etc.  Each  of 
those  mouse  events  has  a separate  method  in  the  interface, 
even  though  they  all  take  a MouseEvent.  If  you  implement 
MouseListener,  the  mousePressed()  method  is  called  when  the 
user  (you  guessed  it)  presses  die  mouse.  And  when  the  user  lets 
go,  the  mouseReleased{)  method  is  called.  So  for  mouse  events, 
there's  only  one  event  object,  MouseEvent,  but  several  different 
event  methods , representing  the  different  types  of  mouse  events. 


V/hen  you  implement  a 
listener  interface,  you  give 
•die  button  a way  to  call 
you  back.  The  interface  is 
where  die  call-back  method 
is  declared. 
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Tke  Listener 

If  your  class  wants  to  know  about 
a button's  Action  Events,  you 
implement  the  ActionLlstener 
interface.The  button  needs  to 
know  you're  Interested,  so  you 
register  with  the  button  by  calling  Its 
addActionLlstener(this)  and  passing  an 
ActionListener  reference  to  It  (in  this  case, 
you  are  the  ActionListener  so  you  pass 
fh/s).The  button  needs  a way  to  call  you 
back  when  the  event  happens,  so  it  calls 
the  method  in  the  listener  Interface.  As  an 
Act  ion  Listener,  you  must  Implement  the 
interface's  sole  method,  actionPerformed(). 
The  compiler  guarantees  It. 


Tke  Event  Source 

A button  Is  a source  of  ActionEvents, 
so  it  has  to  know  which  objects  are 
interested  llsteners.The  button  has  an 
add  Action  ListenerO  method  to  give 
Interested  objects  (listeners)  a way  to 
tell  the  button  they're  interested. 

When  the  button's 
addActionLlstener()  runs  (because 
a potential  listener  invoked  it),  the 
button  takes  the  parameter  (a 
reference  to  the  listener  object)  and 
stores  it  in  a list.  When  the  user  clicks 
the  button,  the  button 'fires' the  event 
by  calling  the  actionPerformedO 
method  on  each  listener  In  the  list. 
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Getting  a button’s  ActionEvent 

G Implement  the  ActionListener  interface 

$ Register  with  the  button  {tell  it  you 
want  to  listen  for  events) 

G Define  the  event-handling  method  (implement 
the  actionPerformedO  method  from  the 
ActionListener  interrface) 


i^ort  javax. swing.  * ; * »ew  ^ are  '<»• 

import  java. awt. event.*;  < — AtttonUste***"  ar,<*  ^ 


t tt,  TV**  sa'fs> 


public  class  SimpleGuilB  implements  ActionListener  { 
JButton  button; 

public  static  void  main  (String []  args)  { 
SintpleGuilB  gui  - new  SimpleGuilB  ()  ; 
gui.go() ; 

} 

public  void  go  (}  { 

JFrame  frame  « new  JFraxne  ( ) ; 
button  « new  JButton ("click  me") ; 


"a*  ’ 


CtM 


.^walr 


/ 


button . addActionListener (this) ; 


, .,v  ^ ^ l . S \\sbe^s  • 

vouv  Lrt  \JOV^“  L Cv'O*'  * 

frame . getContentPane ( ) .add (button) ; 

frame . setDefaultClose<^eration(JFrarne.EXITmON_CLOSE)  ; t . 

frame.  setSize (300,300)  ; AtW^*s^ewC'r  l w 

frame . setVisible  (true)  ; ^ ,x  ^'*S  'S 

public  void  actionPerformed (ActionEvent  event)  { 
button. setText( "I've  been  clicked!"); 

} 


atjumehi  but  we  don't  need  iX**  ■ 1M  * *Ke 

**"■**•«* 
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listeners.  Sources,  and  Events 


For  most  of  your  steUar  Java  career,  you  will  not  be  the  source 
of  events. 


(No  matter  how  much  you  fancy  yourself  the  center  of  your  soda! 
universe.) 


Get  used  to  it.  Your  jifb  is  to  be  a good  listener, : 

(Which,  if  you  do  it  sincerely,  can  improve  your  social  life.) 


As  a listener,  my  job  is  to 
implement  the  interface, 
register  with  the  button,  and 
provide  the  event-handling. 


Listener  GETS  the 
event 


As  an  event  source,  my  job  is  to 
accept  registrations  (from  listeners), 
get  events  from  the  user,  and 
call  the  listener's  event-handling 
method  (when  the  user  clicks  me) 


Source  SENDS 
the  event 


Hey,  what  about  me?  I'm  a player  too,  you 
knowl  As  an  event  object,  I'm  the  argument 
to  the  event  call-back  method  (from  the 
interf  ace)  and  my  job  is  to  carry  data  about 
the  event  back  to  the  listener. 


Event  object 
HOLDS  DATA 
about  the  event 
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Why  can't  I be  a source  of  events? 


You  CAN.  We  Just  said  that  most  of  the  time 
you'll  be  the  receiver  and  not  the  originator  of  the 
eVnt  (at  least  in  the  early  days  of  your  brilliant  Java 
care^^Mos^of'the  events  you  might  care  about 
are 'fired' by  classes  in  the  Java  API,  and  all  you  have 
to  do  Is  be  a listener  for  them.  You  might,  however, 
design  a program  where  you  need  a custom  event, say, 
StockMarketEvent  thrown  when  your  stock  market 
watcher  app  finds  something  it  deems  Important,  In 
that  case, you'd  make  the  StockWatcher  object  be  an 
event  source,  and  you’d  do  the  same  things  a button 
(or  any  other  source)  does — make  a listener  interface 
for  your  custom  event,  provide  a registration  method 
(addStockLlstenerfl),  and  when  somebody  calls  it,  add 
the  caller  (a  listener)  to  the  list  of  Ilsteners.Then,  when 
a stock  event  happens,  instantiate  a StockEvent  object 
(another  class  you'll  write)  and  send  It  to  the  listeners 
In  your  list  by  calling  their  stockChanged(StockEvent 
ev)  method.  And  don't  forget  that  for  every  event  type 
there  must  be  a matching  listener  Interface  (so  you'll 
create  a StockLIstener  interface  with  a stockChangedO 
method). 


J don't  see  the  Importance  of  the  event  object 
that's  passed  to  the  event  call-back  methods.  If 
somebody  calls  my  mousePressed  method,  what 
other  Info  would  I need? 

A lot  of  the  time,  for  most  designs,  you  don't 
need  the  event  object.  It's  nothing  more  than  a little 
data  carrier,  to  send  along  more  info  about  the  event. 
But  sometimes  you  might  need  to  query  the  event  for 
specific  details  about  the  event.  For  example,  If  your 
mousePressed()  method  is  called,  you  know  the  mouse 
was  pressed.  But  what  if  you  want  to  know  exactly 
where  the  mouse  was  pressed?  In  other  words,  what  if 
you  want  to  know  the  X and  Y screen  coordinates  for 
where  the  mouse  was  pressed? 

Or  sometimes  you  might  want  to  register  the  same 
listener  with  multiple  objects.  An  onscreen  calculator, 
for  example,  has  10  numeric  keys  and  since  they  all  do 
the  same  thing,  you  might  not  want  to  make  a separate 
listener  for  every  single  key.  Instead,  you  might 
register  a single  listener  with  each  of  the  10  keys,  and 
when  you  get  an  event  (because  your  event  call-back 
method  is  called)  you  can  call  a method  on  the  event 
object  to  find  out  who  the  real  event  source  was.  In 
other  words,  which  key  sent  this  event . 


-^garpen  your  pencil 

Each  of  these  widgets  (user  Interface  objects)  are  the 

How  do  yo n KNOW  tf 
an  object  is  an  event 

source  of  one  or  more  events.  Match  the  widgets  with 

the  events  they  might  cause.  Some  widgets  might  be  a 
source  of  more  than  one  event,  and  some  events  can  be 

source? 

generated  by  more  than  one  widget. 

Look  In  tho  API. 

Widgets 

Event  methods 

OK.  Look  for  wkat? 

1 

check  box 

wlndowClosing() 

A method  that  starts  with 

text  field 

action  Performed() 

‘add’,  ends  with  ‘Listener*, 
and  takes  a listener  Inter- 

scrolling list 

ItemStateChanged  () 

face  argument.  If  you  see: 

button 

mousePressed() 

addfoyUstone^KayUstemr  k) 

dialog  box 

keylyped() 

you  know  that  a class 
with  this  method  Is  a 

radio  button 

mouseExitedO 

source  of  KeyE vents. 

menu  Item 

focusGained() 

There's  a naming  pattern. 

'j 
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fretting  back  to  graphics... 

Now  that  we  know  a little  about  how  events  work  {we'll  learn 
more  later),  let's  get  back  to  putting  stuff  on  the  screen. 
We'll  spend  a few  minutes  playing  with  some  fun  ways  to  get 
graphic,  before  returning  to  event  handling. 

Three  ways  to  put  things  on  your  GUI: 


“Pcrfr  widgets  on  a frame 

Add  buttons,  menus,  radio  buttons,  etc. 
frame . getCont&ntPane ( ) . add  (myButton) ; 


The  javax.swing  package  has  more  than  a dozen 
widget  types. 


@ Put  a JPE6  on  a widget 

You  can  put  your  own  images  on  a widget, 
graphics . dr aw Image (myPic, 10 , 10 , this)  ; 
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Make  your  own  drawing  widget 


If  you  want  to  put  your  own  graphics  on  the  screen,  your  best 
bet  is  to  make  your  own  pain  table  widget.  You  plop  that  widget 
on  the  frame,  just  like  a button  or  any  other  widget,  but  when  it 
shows  up  it  will  have  your  images  on  it.  You  can  even  make  those 
images  move,  in  an  animation,  or  make  the  colors  on  the  screen 
change  every  time  you  click  a button. 

"it^a_piece  of  cake. 

Make  a subclass  of  JPanel  and  override  one 
method,  paintComponent(). 


All  of  your  graphics  code  goes  inside  the  paintComponent() 
method.  Think  of  the  paintComponent()  method  as  the  method 
called  by  the  system  to  say,  uHey  widget,  time  to  paint  yourself.” 
If  you  want  to  draw  a circle,  the  paintComponent()  method  will 
have  code  for  drawing  a circle.  When  the  frame  holding  your 
drawing  panel  is  displayed,  paintComponent()  is  called  and  your 
circle  appears.  If  the  user  iconifies/minimizes  the  window,  the 
JVM  knows  the  frame  needs  “repair”  when  it  gets  de-iconified, 
so  it  calls  paintComponent()  again.  Anytime  the  JVM  thinks  the 
display  needs  refreshing,  your  paintComponent()  method  will  be 
called. 


One  more  thing,  you  never  call  this  method  yourself!  The  argument 
to  this  method  (a  Graphics  object)  is  the  actual  drawing  canvas 
that  gets  slapped  onto  the  real  display.  You  can't  get  this  by 
yourself;  it  must  be  handed  to  you  by  the  system.  You'll  see 
later,  however,  that  you  can  ask  the  system  to  refresh  the  display 
(repaint()),  which  ultimately  leads  to  paintComponent()  being 
called.  r 


import  java.awt.*; 
import  javax. awing.*; 


,ida.rt 


m*;  a t» »,  fr* 

lti  IS  P ^ t u SMtef%dk.  The 

public  void  paintComponent (Graphics 


class  MyDrawPanel  extends  JPanel  { 


g)  { Vo*  ^ 'Vtirt  S a *'u 

'V  system  ^ 3 rkU  d ty?«  ^r3?V" 

x_  r7  -L  J-WmO.  vtrkitc,  **  n 


£resh  dvaw^ 


; o(  ***“ ' 


that  y**  ^1  ?a"' 


t or  rov-  ■ 


g.setColor (Color. orange) ; 
g.fillRect (20 ,50 ,100 , 100)  ; a V0^e 


j ^ wnax  color  to  i t '.rc 

• sh2P'  <•  P.M  <Z£ 1 ,tte» 

! ll  i°*  J.d  kow  b^itS  "'ito 


364 


chapter  12 


getting  gui 


Fun  things  to  do  in  paintComponentO 

Let's  look  at  a few  more  things  you  can  do  in  paimCoraponent(). 
The  most  fun,  though,  is  when  you  start  experimenting  yourseif. 
Try  playing  with  the  numbers,  and  check  the  API  for  class 
Graphics  (later  we'll  see  that  there's  even  more  you  can  do  besides 
what's  in  the  Graphics  class) . 


^ 6** 


S\W  ***  * 


,oti 


VCf* 


Display  a JPEG 

public  void  paintConrponent  (Graphics  g)  1 ^ 

Image  image  = new  Imagelcon  ("catzilla . jpg")  . getlmage  ()  ; 

— _ — » 

g.drawlmage (image ,3,4, this) ; 

1 

kp.  y (0 

LKc 

^>P  o+  the  p^r  r,  ' P***  +V<*  the 

t*eiau)’  to'  Jii,e  4 1 ***  ^ Jp^iy 


« *>y  tvordi^tts  (a*  usU  r. 

lfcouU  * ?he**  the  pi< Wj , 

^ kd ed>e  j p 

O? tfce  p^r  TL  'nd  f P^l*  ^ th. 


Paint  a randomly-colored  circle 
on  a black  background 

public  void  paintComponent (Graphics  g) 


g.fillReot (0 , 0 , this . getWidth () , this . getHeight () ) ; 


int  red  = (int)  (Math . random  ()  * 255); 
int  green  = (int)  (Math. random ()  * 255); 
int  blue  = (int)  (Math. random ()  * 255) ; 


Color  randomColor  = new  Color (red,  green,  blue); 


^ ) r ^ ,e  to'  (*,y)  uf?Cy  |ef£ 

iiar+I'  ^ n f)  ■k*  w^er«  dravina 

rii^A  0 pixels  Wo»  -the 

/k  l34  d ° P‘*?ls  to'  toy  'dot"  TV 

“tor  to*  My,  >ke  tfc  widfi 
ake  the  he<3ht  a,  tall  ax  the  Pa*el  (thi^heijht)” 


g. setColor (randomColor) ; 
g.fillOval (70,70, 100, 100) 

/* 

fW  no 


f-totoy,  fjjj  to'  kfi  no  £ 
0 plx<:,s  toll.  p'xe/l 


/ou  ^ 

^ £££**  in  3 i-t 
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Behind  every  good  Graphics  reference 
is  a 0raphics2£  object. 

The  argument  to  paintComponent()  is  declared  as  type 
Graphics  (java.awi  Graphics). 

public  void  paintCoraponent  (Graphica  g)  { } 

So  the  parameter  ‘g’  IS-A  Graphics  object  Which  means  it 
could  be  a subclass  oi Graphics  (because  of  polymorphism). 
And  in  fact,  it  is. 

The  object  referenced  by  the  ‘g*  parameter  is  actually  an 
instance  of  the  Graphics2D  class. 

Why  do  you  care?  Because  there  are  things  you  can  do  with 
a Grapbic$2D  reference  that  you  can't  do  with  a Graphics 
reference.  A Graphics2D  object  can  do  more  than  a Graphics 
object,  and  it  really  is  a Graphics2D  object  lurking  behind  the 
Graphics  reference. 

Remember  your  polymorphism.  The  compiler  decides  which 
methods  you  can  call  based  on  the  reference  type,  not  the 
object  type.  If  you  have  a Dog  object  referenced  by  an  Animal 
reference  variable: 

Animal  a = new  Dog  ()  ; 

You  can  NOT  say: 
a .bark  ()  ; 

Even  though  you  know  it's  really  a Dog  back  there.  The 
compiler  looks  at  V,  sees  that  it’s  of  type  Animal,  and  finds 
that  there's  no  remote  control  button  for  bark()  in  the  Animal 
class.  But  you  can  still  get  the  object  back  to  the  Dog  it  really  is 
by  saying: 

Dog  d * (Dog)  a; 
d.barkO  ; 

So  the  bottom  line  with  the  Graphics  object  is  this: 

If  you  need  to  use  a method  from  the  Graphics2D  class,  you 
can’t  use  the  the  paintCompooent  parameter  (‘g*)  straight 
from  the  method.  But  you  can  cast  it  with  a new  Graphics  2D 
variable. 

Graphics2D  g2d  = (Graphics2D)  g; 


Methods  you  can  call  on  a 
Graphics  reference: 

drawlmage() 

drawUneQ 

drawPolygon 

draw  Rect() 

drawOval() 

flllRectO 

flliRoundRectO 

setColorQ 

To  cast  the  Graphics2D  object  to 
a Graphlcs2D  reference: 

Graphics2D  g2d  = (Graphics2D)  g; 

Methods  you  can  call  on 
a Graphlcs2D  reference: 

fill3DRect() 

draw3D  Rect() 

rotate() 

scale() 

shearQ 

trangformO 

setRend  ering  H I n ts( ) 

(these  are  hot  eomylete  method  lists, 
tKedk  the  API  t more) 
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Because  life's  too  short  to  paint  the 
circle  a solid  color  when  there's  a 
gradient  blend  waiting  for  you. 


public  void  parintCoanponent  (Graphics  g)  ( 

Graphic«D  g2d  = (Graphics2D)  g; 

££*t  it  so  VJ€  £a)|  Somethin*  tkat 


edit  It  so  *J€  63*  ^ail  Sorr^thmA  that 

dpapkitslD  has  but  ^raphia  doesn't 


GradientPaint  gradient  = new  GradientPaint (70 , 70 , Color .blue,  150,150,  Color. orange) ; 


T,  **din3 

h3  3 *3  poini  3 ^ 


'^2Zjeit  ^ **•}  f**  U b>  3 

g2d . aatPaint  ( gradient) ; 3*™C"t  iwfcad  <£  a 


g2d. fillOval<70,70, 100, 100)  ; 


, J ^Vj  wear>s 


°"3  * (u  tVvC  ^a<J,tT,y 


tJbrusk 


public  void  paintComponent (Graphics  g)  ( 

Graphics 2D  g2d  = (Graphics2D)  g; 

int  red  = (int)  (Math . random ()  * 255); 
int  green  = (int)  (Math .random ()  * 255) ; 
int  blue  = (int)  (Math . random ()  * 255); 

Color  atartColor  = new  Color(red,  green,  blue); 

red  = (int)  (Math . random  ( ) * 255); 
green  - (int)  (Math. random ()  * 255); 
blue  = (int)  (Math . random ( ) * 255); 

Color  endColor  = new  Color (red,  green,  blue); 

GradientPaint  gradient  =*  new  GradientPaint (70 ,70 , atartColor , 150,150,  endColor); 
g2d. eetPaint (gradient) ; 
g2d.fillOval (70,70,100,100) ; 


yts^d^  Ve 
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BULLCT  POINTS 


EVENTS 

■ To  make  a GUI,  start  with  a window,  usually  a JFrame 

JFrame  frame  - new  JFrame ( ) ; 

■ You  can  add  widgets  (buttons,  text  fields,  etc.)  to  the 
JFrame  using: 

frame.  gatContantPajne  O . add  (button)  ; 

■ Unlike  most  other  components,  the  JFrame  doesn't  let 
you  add  to  it  directly,  so  you  must  add  to  the  J Frame's 
content  pane. 

■ To  make  the  window  (JFrame)  display,  you  must  give  It 
a size  and  tel)  it  be  visible: 

frame . setSize  (300,300) ; 
frame . aatViaible (true) ; 

■ To  know  when  the  user  clicks  a button  (or  takes  some 
other  action  on  the  user  interface)  you  need  to  listen  for 
a GUI  event. 

■ To  listen  for  an  event,  you  must  register  your  Interest 
with  an  event  source,  An  event  source  is  the  thing  (but- 
ton, checkbox,  etc.)  that  ‘fires’  an  event  based  on  user 
interaction. 

■ The  listener  interface  gives  the  event  source  a way 
to  call  you  back,  because  the  Interface  defines  the 
method(s)  the  event  source  will  call  when  an  event 
happens. 

“ To  register  for  events  with  a source,  call  the  source's 
registration  method.  Registration  methods  always  take 
the  form  of:  add<Ev6ntType>Ustener.  To  register  for  a 
button's  ActionEvents,  for  example,  call: 
button. addActionliistener (this)  ; 

■ Implement  the  listener  interface  by  implementing  all  of 
the  interface’s  event-handling  methods.  Put  your  event- 
handling  code  in  the  listener  call-back  method.  For 
ActionEvents,  the  method  is: 

public  void  act!  on  Performed  (ActionEvant 

©vent)  { 

button.  setText  ("you  elicited!  ")  ; 

) 

■ The  event  object  passed  into  the  event-handler  method 
carries  Information  about  the  event,  Including  the  source 
of  the  event. 


GRAPHICS 

■ You  can  draw  2D  graphics  directly  on  to  a widget 

■ You  can  draw  a .gif  or  .jpeg  directly  on  to  a widget 

■ To  draw  your  own  graphics  (including  a .gif  or  .jpeg), 
make  a subclass  of  JPanel  and  override  the  paintCom- 
ponent()  method. 

■ The  paintComponentQ  method  is  called  by  the  GUI 
system,  YOU  NEVER  CALL  IT  YOURSELF.  The  argu- 
ment to  paintComponentO  is  a Graphics  object  that 
gives  you  a surface  to  draw  on,  which  will  end  up  on 
the  screen.  You  cannot  construct  that  object  yourself. 

■ Typical  methods  to  call  on  a Graphics  object  (the  paint- 
Component  paramenter)  are: 

graphics . setColor (Color .blue) ; 
g.fillRect (20,50,100,120) ; 

■ To  draw  a .jpg,  construct  an  Image  using: 

Image  image  - new  Image loon ("ca trills . 
jpg") .getlmage () ; 

and  draw  the  Imagine  using: 
g . drawlmage (image ,3,4, this) ; 

■ The  object  referenced  by  the  Graphics  parameter 
to  paintComponentO is  actually  an  instance  of  the 
Graphlcs2D  class.  The  Graphics  2D  class  has  a variety 
of  methods  including: 

mi3DRectO,  draw3DRectO.  rotate().  scale (),  shear(), 
transformO 

■ To  invoke  the  Graphics2D  methods,  you  must  cast  the 
parameter  from  a Graphics  object  to  a Graphlcs2D 
object: 

Graphics2D  g2d  = (Graphics2D)  g; 
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We  can  get  an  event. 

We  can  paint  graphics. 

Put  can  we  paint  graphics  when  we  get  an  event? 

Let's  book  up  an  event  to  a change  in  our  drawing  panel.  We'll  make  the  circle 
change  colors  each  time  you  click  the  button.  Here’s  how  the  program  flows: 


Start  the  app 


The  frame  is  built  with  the  two  widgets 
(your  drawing  panel  and  a button).  A 
listener  is  created  and  registered  with 
the  button.  Then  the  frame  is  displayed 
and  it  just  waits  for  the  user  to  click. 


The  user  clicks  the  button  and  the 
button  creates  an  event  object  and 
calls  the  listener's  event  handler. 


o The  event  handler  calls  repaint()  on  the 
frame.  The  system  calls  paintComponent() 
on  the  drawing  panel. 


Voila!  A new  color  is  painted  because 
paint£omponent()  runs  again,  filling  the 
circle  with  a random  color. 
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&UI  layouts:  putting  wore  than  one 
widget  on  a frame 

We  cover  GUI  layouts  in  the  next  chapter,  but  we’ll  do  a 
quickie  lesson  here  to  get  you  going.  By  default,  a frame 
has  five  regions  you  can  add  to.  You  can  add  only  one  thing 
to  each  region  of  a frame,  but  don’t  panic!  That  one  thing 
might  be  a panel  that  holds  three  other  things  including  a 
panel  that  holds  two  more  things  and...  you  get  the  idea.  In 
fact,  we  were  ‘cheating'  when  we  added  a button  to  the  frame 
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The  circle  changes  color  each  time  you 
click  the  button. 


Import  javax. swing ; 
import  java^awt.*; 
import  java . awt. event . 


public  class  3impleGui3C | implements  ActionListaner 
JFrame  frame;  \ 


public  static  void  main  (String []  arga)  ( 
SimpIeGui3C  gui  = new  SimpleGui3C  () ; 
gui.go()  ; 

} 


\yt  ^3"'e 


public  void  go()  ( 

frame  = new  JFrama  ()  ; 

frame . aetDef aultCloseOperation  ( JFrame . EXI  T_ON_CLOSE ) ; 


JButton  button  = new  JButton ( "Change  colors' 
button . addActionListener (this) ; ^ 


(^4) 


to3**' 


) 


MyDrawPanel  drawPanel  = new  MyDrawPanel () ; 

frame . ga  tContentPane ( ) . add (BorderLayout . SOUTH , 
frame . ga  tContentPane  ()  . add  (BorderLayout . CENTER, 
frame . setSize (300 , 300) ; 
frame . aetVisibla (true) ; 


button) . 
drawPanel) 


trim?*  'rt*'°*S 


public  void  actionPerformed (ActionEvent  event)  ( 
frame . repaint ()  ; 

1 WrfTS-" 

*£()  ,s  uUtd  w vir'l 


the  W*™t\ 


class  MyDrawPanel  extends  JPanel  { 

public  void  pain tComponent  (Graphics  g)  { P3'*tCo*p0>,,.  </) 

//  Code  to  fill  the  oval  with  a random  color  &cty  ^ ^ ' 

//  See  page  347  for  the  code 

) 


} 
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/ Let's  try  it  with  TWO  buttons 

The  south  button  will  act  as  it  does  now,  simply  calling  repaint  on  the 
frame.  The  second  button  (which  we’ll  suck  in  the  east  region)  will 
change  the  text  on  a label.  (A  label  isjust  text  on  the  screen.) 

So  now  we  need  FOUR  widgets 


j'!  Wk  Ik*,),,  tk<  U,\ur 
or  th<  circle 


And  we  need  to  get 
TWO  events 


Uh-oh. 

Is  that  even  possible?  How  do 
you  get  two  events  when  you 
have  only  on^acbonPerfonnedO 
method? 

TVlis  button  changes  the  te*t 

on  the  opposite  side 
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How  do  you  get  action  events  for  two  different  buttons, 

when  each  button  needs  to  do  something  different? 

/ 


^ option  one 

Implement  two  actionPerformed()  methods 

cl&aa  MyGui  implements  Actionliistenar  { 

//  lots  of  a ode  here  and  then: 

public  void  actionPer formed (ActionEvent  event)  f 

frame . repaint  ( > ; ^ Bet  tfcii  U i*Po*ible/ 

public  void  actionPer formed (ActionEvent  event)  { 
label. eetTaxt( "That  hurt!"); 

) 

) 

Flaw:  You  can*tl  You  can't  Implement  the  same  method  twice  in  a Java  class.  It  won't  compile. 
And  even  if  you  could,  how  would  the  event  source  know  which  of  the  two  methods  to  call? 


£ option  two 

Register  the  same  listener  with  both  buttons. 

class  MyGui  implements  ActionLiatanar  { 

//  declare  a bunch  of  Instance  variables  here 

public  void  go  0 { 

//  build  gui 

colorButton  = new  JButton(); 
labelButton  = new  JButton ( ) ; 

colorButton.  addActionliistener  (this)  ; Kfjis'fcsr  lirfc^v- 

labelButton .addActiocListener  (this)  / both  bu-fc^^ 

//  more  gui  code  here  . . . 

> 


} 


public  void  actionPer  formed  (ActionEvent  event)  { 


if  (event 
frame 
} else  { 

label. setText( 


getSource ( ) 
repaint  ()  ; 


colorButton) 


‘That  hurt*") 


.fete* 

use 


Flaw:  this  does  work,  but  In  most  cases  It’s  not  very  OO.  One  event  handler 
doing  many  different  things  means  that  you  have  a single  method  doing  many  different  things. 
If  you  need  to  change  how  one  source  is  handled,  you  have  to  mess  with  everybody's  event 
handler. Sometimes  It  is  a good  solution,  but  usually  it  hurts  maintainability  and  extensibility. 
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How  do  you  get  action  events  for  two  different  buttons, 
when  each  button  needs  to  do  something  different? 


^ option  three 

Create  two  separate  ActionListener  classes 

class  MyGui  { 

JFrame  frame; 

JLabal  label; 
void  gui ( ) { 

//  code  to  instantiate  the  two  listeners  and  register  one 
//  with  the  color  button  and  the  other  with  the  label  button 

> 

) //  close  class 


class  ColorButtonlistener  implements  ActionListener  { 
public  void  a ctionPer formed (ActionEvent  event)  { 
frame . repaint  ( ) ; 

iKe  ‘W  variable  of  V*  Atyfa  t\au 


class  Labe lButtonLis tana r implements  ActionListener  { 
public  void  actionPerformed(ActionEvent  event)  { 
label. setText( "That  hurt!"); 

, ^ POM  TW,  £|*,  u „ t.  tt,  wublt  Ul|. 


Flaw:  these  classes  wont  have  access  to  the  variables  they  need 

to  act  on,  ‘frame’  and  ‘label’.  You  could  fix  It,  but  you'd  have  to  give  each  of  the 
listener  classes  a reference  to  the  main  GUI  class,  so  that  Inside  the  actlonPerformedO 
methods  the  listener  could  use  the  GUI  class  reference  to  access  the  variables  of  the  GUI 
class.  But  that's  breaking  encapsulation, so  we'd  probably  need  to  make  getter  methods 
for  the  gul  widgets  (getFrameQ,  getLabelO,etc.).  And  you'd  probably  need  to  add  a 
constructor  to  the  listener  class  so  that  you  can  pass  the  GUI  reference  to  the  listener  at 
the  time  the  listener  is  instantiated.  And,  well,  it  gets  messier  and  more  complicated. 

There  has  got  to  be  a better  wayt 
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Wouldn't  it  be  wonderful  if  you  ^ 

could  have  two  different  listener  classes,  4 
but  the  listener  classes  could  access  the 
instance  variables  of  the  main  GUI  class, 
almost  as  if  the  listener  classes  belonged 
to  the  other  class.  Then  you'd  have  the  best 
of  both  worlds.  Yeah,  that  would  be  dreamy. 

But  it’s  just  a fantasy...  ^ 


m 

Air 
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Inner  class  to  the  rescue! 

You  can  have  one  class  nested  inside  another.  It's  easy. 
Just  make  sure  that  the  definition  for  the  inner  class  is 
inside  the  curly  braces  of  the  outer  class. 


Simple  inner  class: 


class  MyOuterClass  { 

Class  MylnnerClass  { I 

void  go(>  { 1 t\ostW 

) 

) 


An  inner  class  gets  a special  pass  to  use  the  outer  class's  stuff.  Even 
the  private  stuff \ And  the  inner  class  can  use  those  private  variables 
and  methods  of  the  outer  class  as  Lf  die  variables  and  members 
were  defined  in  the  inner  class.  That's  what's  so  handy  about  inner 
classes — they  have  most  of  the  benefits  of  a normal  class,  but  with 
special  access  rights. 


An  inner  class  can 
use  all  tlie  method* 
and  variables  of  the 
outer  class,  even  the 
private  one.*. 

The  inner  class  gets 
to  use  those  variables 
and  methods  just 
as  if  the  methods 
and  variables  were 
declared  within  the 
inner  class. 


Inner  class  using  an  outer  class  variable 

class  MyOuterClass  { 
private  int  x; 


class  MylnnerClass  { 
void  go ( ) { 

x = 42;  — 

) 

} //  close  inner  class 


as  ijf  it  vtrt  a variable 
0$  t be  tla«! 


I I 
* 


} //  close  outer  class 
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An  inner  class  instance  must  be  tied  to 
an  outer  class  instance*. 

Remember,  when  we  talk  about  an  inner  class  accessing 
something  in  the  outer  class,  we're  really  talking  about  an 
instance  of  the  inner  class  accessing  something  in  an  instance  of 
the  outer  class.  But  which  instance? 

Can  <^iy  arbitrary  instance  of  the  inner  class  access  the  methods 
and  variables  of  any  instance  of  the  outer  class?  No! 


An  inner  object 
shares  a special 
bond  with  an 
outer  object.  ^ 


(£)  The  outer  and  inner  objects 
are  now  intimately  linked. 


(1)  Make  an  instance  of 
the  outer  class 


/rrrveT 


An  inner  object  must  be  tied  to  a specific  outer  object 
the  heap. 


cm 


(^)  Make  an  instance  of 
the  inner  class,  by 
using  the  instance 
of  the  outer  class. 


There's  an  exception  to  this,  for  a very  special  case — an  Inner  class  defined 
within  a static  method.  But  we're  not  going  there,  and  you  might  go  your  entire 
Java  life  without  ever  encountering  one  of  these. 
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How  to  wake  an  instance  of  an  inner  class 


If  you  instantiate  an  inner  class  from  code  urilkm  an  outer  class,  the  instance 
of  the  outer  class  is  the  one  that  the  inner  object  will  'bond*  with.  For 
example,  if  code  within  a method  instantiates  the  inner  class,  the  inner 
object  will  bond  to  the  instance  whose  method  is  running. 

Code  in  an  outer  class  can  instantiate  one  of  its  own  inner  classes,  in  exactly 
the  same  way  it  instantiates  any  other  class...  new  My  Inner  ( ) 


class  MyOuter  { 
private  int  x; 

Mylnner  inner  = new  My Inn ex () 


i _ has  a ^ 

T^wt£r.S,V 


,vate 


dr,  ^ ^ 


public  void  doStuff()  { 

in^ev*  £-lc)*s 


} 


MyOuter 


class  Mylnner  { 
void  go ()  { 

* - 42;  J^_ 


th« 


> 


Tht  method  the  in r*r  Class  u*Cl  th 
outer  fclas*  iwtdnCe  variable  a*  '+ 


I 1 
* 


) //  close  inner  class  btlon^td  to  the  ^^4S* 
} //  close  outer  class 


r Side  bar 


You  can  instantiate  an  inner  instance  from  code  running  outside  the  outer  class,  but  you 
have  to  use  a special  syntax.  Chances  are  you'll  go  through  your  entire  Java  life  and  never 
need  to  make  an  Inner  class  from  outside,  but  just  In  case  you're  Interested... 

class  Foo  { 

public  static  void  main  (String []  args)  ( 

MyOuter  outerObj  = daw  MyOuter ( ) ; 

MyOuter  .Mylnner  irmerObj  = outerOb j . new  Mylnner  ()  ; 


MyOuter 


> 


) 


Mylnner 
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Now  we  can  get  the  two-button 
code  working 

<*?«***  w 


public  class  TwoButtons  { 


JFrataa  frame; 

JLabel  label; 

/ 

public  static  void  main  (String []  axgs)  ( 
TwoButtons  gui  = new  TwoButtons  () ; 
gui.  go  ()  ; 

) 


public  void  go()  { 

frame  = new  JFrame() ; 

frame  . setDefaul  tCloseOperation  (JFrame  ,EXIT_ON_CLOSE)  ; 


JButton  labelButton  = new  JButton ("Change  Label") ; 
label  But  ton . addActionListener  (new  L&belListener  ( ) ) ; 

JButton  colorButton  = new  JButton ("Change  Circle"); 
colorButton . addActionListaner  (new  ColorListener  {) ) ; 


label  = new  JLabel("I'm  a label"); 

MyDrawPanel  drawPanel  = new  MyDrawPanel () ; 

frame . getContentPane () , add (Border Lay out. SOUTH,  colorButton) 
frame . getContentPane () . add (BorderLayout , CENTER,  drawPanel) ; 
frame . getContentPane () .add (BorderLayout, EAST,  labelButton) ; 
frame . getContentPane () . add (BorderLayout .WEST,  label) ; 


TwoButtons 

object 


frame . satSize (300, 300) 
frame . setVisible (true) 


) 


class  LabelLiu  tener  implements  ActionLis  toner  { 

public  void  actionPerformed(ActionEvent  event) 
label. setText ("Ouch! ") ; 

1 ^ — ■ iri***-  knowi 

) //  close  inner  class  abou^ 

class  ColorLia toner  implements  ActionListaner  { 

public  void  act ion Per formed (ActionEvent  event)  { 
frame. repaint () ; 

"tbe  in 


. , , .Jr  to  havt 

m 3 


object 


) 


> 

II 


close  inner  class 


the  ih / 


t havi 


ran><’ 


'rt*ertriU  {*  fi  ^ 

w the  oute>- 
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He  ad  First:  What  makes  inner  classes  important? 

Inner  object:  Where  do  I start?  We  give  you  a chance  to 
implement  the  same  interface  more  than  once  in  a class. 
Remember,  you  can’t  implement  a method  more  than 
once  in  a normal  Java  class.  But  using  inner  classes,  each 
inner  class  can  implement  the  same  interface,  so  you  can 
have  all  these  different  implementations  of  the  very  same 
interface  methods. 

HeadFirst:  Why  would  you  ever  want  to  implement  the 
same  method  twice? 

Inner  object:  Let’s  revisit  GUT  event  handlers.  Think 
about  it...  if  you  want  three  buttons  to  each  have  a 
different  event  behavior,  then  use  three  inner  classes,  all 
implementing  ActionListenei — which  means  each  class 
gets  to  implement  its  own  actio nPerformed  method. 

HeadFirst:  So  are  event  handlers  the  only  reason  to  use 
inner  classes? 

Inner  Object:  Oh,  gosh  no.  Event  handlers  are  just  an 
obvious  example.  Anytime  you  need  a separate  class,  but 
still  want  that  class  to  behave  as  if  it  were  part  of  another 
class,  an  inner  class  is  the  best — and  sometimes  only — way 
to  do  it. 

HeadFirst  I’m  still  confused  here.  If  you  want  the  inner 
class  to  behave  like  it  belongs  to  the  outer  class,  why  have 
a separate  class  in  the  first  place?  Why  wouldn’t  the  inner 
class  code  just  be  in  the  outer  class  in  the  first  place? 

Inner  object  I just  gave  you  one  scenario,  where  you 
need  more  than  one  implementation  of  an  interface.  But 
even  when  you’re  not  using  interfaces,  you  might  need 
two  different  classes  because  those  classes  represent  two 
different  things.  It’s  good  OQ 

HeadFirst  Whoa.  Hold  on  here.  I thought  a big  part  of 
OO  design  is  about  reuse  and  maintenance.  You  know,  the 
idea  that  if  you  have  two  separate  classes,  they  can  each 
be  modified  and  used  independently,  as  opposed  to  stuffing 
it  all  into  one  class  yada  yada  yada.  But  with  an  inner  class, 
you’re  still  just  working  with  one  real  class  in  the  end,  right? 
The  enclosing  class  is  the  only  one  that’s  reusable  and 


j&va  Expos*) 

This  weeks  interview: 

Instance  of  an  Inner  Class 

separate  from  everybody  else.  Inner  classes  aren’t  exactly 
reusable.  In  fact,  T’ve  heard  them  called  "Reuseless — 
useless  over  and  over  again?’ 

Inner  object:  Yes  it’s  true  that  the  inner  class  is  not  as 
reusable,  in  fact  sometimes  not  reusable  at  all,  because  it’s 
intimately  tied  to  the  instance  variables  and  methods  of 
the  outer  class.  But  it — 

HeadFirst:  — which  only  proves  my  point!  If  they’re  not 
reusable,  why  bother  with  a separate  class?  I mean,  other 
than  the  interface  issue,  which  sounds  like  a workaround 
to  me. 

Inner  object:  As  I was  saying,  you  need  to  think  about 
IS-A  and  polymorphism. 

HeadFirst:  OK.  And  I’m  thinking  about  them  because... 

Inner  object:  Because  the  outer  and  inner  classes 
might  need  to  pass  different  IS-A  tests!  Let’s  start  with  the 
polymorphic  GUI  listener  example.  What’s  the  declared 
argument  type  for  the  button’s  listener  registration 
method?  In  other  words,  if  you  go  to  the  API  and  check, 
what  kind  of  thing  (class  or  interface  type)  do  you  have  to 
pass  to  the  addActionlistenerO  method? 

HeadFirst  You  have  to  pass  a listener  Something  that 
implements  a particular  listener  interface,  in  this  case 
AcoonListener.  Yeah,  we  know  all  this.  What’s  your  point? 

Inner  object:  My  point  is  that  polymorphically,  you  have 
a method  that  takes  only  one  particular  type.  Something 
that  passes  the  IS-A  test  for  ActionListener.  But — and 
here’s  the  big  thing — what  if  your  class  needs  to  be  an  IS- 
A of  something  that’s  a class  type  rather  than  an  interface? 

HeadFirst:  Wouldn’t  you  have  your  class  just  extend  the 
class  you  need  to  be  a part  of?  Isn’t  that  the  whole  point 
of  how  subclassing  works?  If  B is  a subclass  of  A,  then 
anywhere  an  A is  expected  a B can  be  used.  The  whole 
pass-a- Dog- where -an -Animal -is- the- declared -type  thing 

Inner  object:  Yes!  Bingo!  So  now  what  happens  if  you 
need  to  pass  the  IS-A  test  for  two  different  classes?  Classes 
that  aren’t  in  the  same  inheritance  hierarchy? 
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HeadFirst:  Oh,  well  you  just,.,  hmmm.  I think  I'm  get- 
ting it.  You  can  always  implement  more  than  one  interface, 
but  you  can  extend  only  one  class.  You  can  only  be  one  kind 
.of  IS-A  when  it  comes  to  class  types. 

Inner  object:  Well  done!  Yes,  you  can’t  be  both  a Dog 
and  a Burton.  But  if  you're  a Dog  that  needs  to  some- 
times be  a Button  (in  order  to  pass  yourself  to  methods 
that  take  a Button),  the  Dog  class  (which  extends  Animal 
so  it  can’t  extend  Burton)  can  have  an  inner  class  that  acts 
on  the  Dog's  behalf  as  a Burton,  by  extending  Bunon, 
and  thus  wherever  a Button  is  required  the  Dog  can 
pass  his  inner  Button  instead  of  himself.  In  other  words, 
instead  of  saying  x.takeBuuon(this),  the  Dog  object  calls 
x.takeButton(new  MylnnerButtonQ). 

HeadFirst:  Can  I get  a clear  example? 

Inner  object:  Remember  the  drawing  panel  we  used, 
where  we  made  our  own  subclass  of  JPanel?  Right  now, 
that  class  is  a separate,  non-inner,  class.  And  that’s  hne, 
because  the  class  doesn’t  need  special  access  to  the  instance 
variables  of  the  main  GUI.  But  what  if  it  did?  What  if 
we’re  doing  an  animation  on  that  panel,  and  it's  getting  its 
coordinates  from  the  main  application  (say,  based  on  some- 
thing the  user  does  elsewhere  in  the  GUI),  In  that  case,  if 
we  make  the  drawing  panel  an  inner  class,  the  drawing 
panel  class  gets  to  be  a subclass  of  JPanel,  while  the  outer 
class  is  still  free  to  be  a subclass  of  something  else. 

HeadFirst:  Yes  I see!  And  the  drawing  panel  Isn’t  reus- 
able enough  to  be  a separate  class  anyway  since  what  it's 
actually  painting  is  specific  to  this  one  GUI  application. 

Inner  object:  Yes!  You've  got  it! 

HeadFirst:  Good,  Then  we  can  move  on  to  the  nature  of 
the  relationship  between  you  and  the  outer  instance. 

Inner  object:  What  is  it  with  you  people?  Not  enough 
sordid  gossip  in  a serious  topic  Like  polymorphism? 

HeadFirst  Hey  you  have  no  idea  how  much  the  public  is 
willing  to  pay  for  some  good  old  tabloid  dirt.  So,  someone 
creates  you  and  becomes  instantly  bonded  to  the  outer 
object,  is  that  right? 

Inner  object:  Yes  that's  right.  And  yes,  some  have 
compared  it  to  an  arranged  marriage.  We  don't  have  a say 
in  which  object  we're  bonded  to. 

HeadFirst:  Alright,  I'll  go  with  die  marriage  analogy. 

Can  you  get  a divorce  and  remarry  something  else? 

Inner  object:  No,  it’s  for  life. 


HeadFirst:  Whose  life?  Yours?  The  outer  object?  Both? 

Inner  Object:  Mine.  I can't  be  tied  to  any  other  outer 
object,  My  only  way  out  is  garbage  collection. 

HeadFirst:  What  about  the  outer  object?  Can  it  be 
associated  with  any  other  inner  objects? 

Inner  object  So  now  we  have  it.  This  is  what  you  really 
wanted.  Yes,  yes.  My  so-called  'mate'  can  have  as  many 
inner  objects  as  it  wants. 

HeadFirst:  Is  that  like,  serial  monogamy?  Or  can  it  have 
them  all  at  the  same  time? 

Inner  object:  All  at  the  same  time.  There.  Satisfied? 

HeadFirst:  Well,  it  does  make  sense.  And  let’s  not 
forget,  it  wa syou  extolling  the  virtues  of  "multipLe 
implementations  of  the  same  interface".  So  it  makes  sense 
that  if  the  outer  class  has  three  buttons,  it  would  need 
three  different  inner  classes  (and  thus  three  different  inner 
class  objects)  to  handle  the  events.  Thanks  for  everything 
Here's  a tissue. 
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Using  an  inner  class  for  animation 

We  saw  why  inner  classes  are  handy  for  event  listeners,  because 
you  get  to  implement  the  same  event-handling  method  more 
than  once.  But  now  we'll  look  at  how  useful  an  inner  class  is  when 
used  as  a subclass  of  something  the  outer  class  doesn't  extend.  In 
other  words,  when  the  outer  class  and  inner  class  are  in  different 
inheritance  trees! 

Our  goal  is  to  make  a simple  animation,  where  the  circle  moves 
across  the  screen  from  the  upper  left  down  to  the  lower  right, 

finish 


How  simple  animation  works 

& Paint  an  object  at  a particular  x and  y coordinate 

g.fillOval (20^50,100,100) ; 

^2 JO  pixels  -Cror*  tk t lePi, 

50  pixels  -Prom  the  top 


Repaint  the  object  at  a^different  x and  y coordinate 

g .fillOval  (25 ,55,100,100)  ; 


*^2.5  pixels  -Pro*  tke  le-Ptj  56 

els  (r 


pi*ek 


ike  top 


(ike  objeei  »o ved  a liiile 
dow*  and  io  ike  ri^kt) 


@ Repeat  the  previous  step  with  changing  x and  y values 
for  as  long  as  the  animation  is  supposed  to  continue. 


Why  are  we  learning  about 
animation  here?  I doubt  if  I'm 
going  to  be  making  games. 

You  might  not  be  making 
games,butyou  might  be 
creating  simulations,  where 
things  change  over  time  to  show 
the  results  of  a process.  Or  you 
might  be  building  a visualization 
tool  that,  for  example,  updates 
a graphic  to  show  how  much 
memory  a program  is  using, 
or  to  show  you  how  much 
traffic  is  coming  through 
your  load-balancing  server. 
Anything  that  needs  to  take  a 
set  of  continuously-changing 
numbers  and  translate  them  Into 
something  useful  forgetting 
Information  out  of  the  numbers. 

Doesn't  that  all  sound  business- 
like? That's  just  the'official 
justification*  of  course.The  real 
reason  we're  covering  it  here  Is 
Just  because  it's  a simple  way 
to  demonstrate  another  use 
of  Inner  classes.  (And  because 
we  Just  like  animation,  and  our 
next  Head  First  book  Is  about 
J2EE  and  we  know  we  can't  get 
animation  in  that  one.) 
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What  we  really  want  is  something  like... 


ltiai 


class  MyDrawPnnel  extends  JPanel  { 

public  void  paintCounponent  (Graphics  g)  { 
g. setColor (Color. orange) ; 
g.flllOval (x,y, 100 , 100)  ; 


> 


} 


satgnSi'-" 


a^jwpen  your  pencil 


But  where  do  we  get  the  new  x and  y 
coordinates? 


And  who  calls  repaintQ? 

See  if  you  can  design  a simple  solution  to  get  the  ball  to  animate  from  the  top  left  of  the 
drawing  panel  down  to  the  bottom  right  Our  answer  Is  on  the  next  page,  so  don't  turn 
this  page  until  you're  done! 

Big  Huge  Hint  make  the  drawing  panel  an  inner  class. 

Another  Hint  don't  put  any  kind  of  repeat  loop  In  the  palntComponentO  method. 

Write  your  ideas  (or  the  code)  here: 
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complete  simple  animation  code 

import  javax. swing.*; 

Import  java.awt.*; 


public  class  S LmpleAnimation 


fc»o 

6rL\e- 


public  static  void  main  (String []  args)  ( 

SimplaAnimation  gui  = n m SimpleAnimation  ( ) ; 
gui.go()  ; 

} 


public  void  go()  { 

JFrame  frame  = new  JFrame  ( ) ; 

frame . aetDefaultCloaeOperation (JFrame . EX I T_ON_CLOSE ) ; 


MyDrawPanel  drawPanal  = new  MyDrawPanel () ; 

fraroe.getContentPaneO  .add(drawPanel)  ; 
frame , setSize (300  , 300) ; 
frame . setVisible (true) ; 


widgtfc. 


TVis « 


VjVipri 

'd 


£o*  (Int  i * 0;  i < 130;  i++)  { *reP“‘t  &is  I 10  *imei 


£k«  x and  y 


dsavPanel . repaint  0 ; btW  *** 


try  { 

Thread. sleep (SO ) 


tit,  *« 


) c»teh (Exemption  «)  ( ) p f — " 


}//  close  go<)  method 


'Ai*  **  class  MyDrawPanel  extends  JPanel  ( 

public  void  paintComponent (Graphics  g)  { 
g. setColor (Color .green) ; 
g.fillOvxl  (x,y,40,40);  Uu  tl* 

) //  close  inner  class 
} i I close  outer  class 
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Uh-on.  It  didn't  move...  it  smeared. 


What  did 


idjwe  do 


7 


wrong? 


There's  one  little  flow  in  the  paintComponentQ 
method. 


We  forgot  to  erase  what  was 
already  there!  So  we  got  trails. 

To  fix  it,  all  we  have  to  do  is  fill  in  the  entire  panel  with 
the  background  color,  before  painting  the  circle  each 
time.  The  code  below  adds  two  lines  at  the  start  of  the 
method:  one  to  set  the  color  to  white  (the  background 
color  of  the  drawing  panel)  and  the  other  to  fill  the 
entire  panel  rectangle  with  that  color.  In  English,  the 
code  below  says,  "Fill  a rectangle  starting  at  x and  y of 
0 (0  pixels  from  the  left  and  0 pixels  from  the  top)  and 
make  it  as  wide  and  as  high  as  the  panel  is  currently. 


publia  void  paintComponent (Graphics  g)  { 
g.setColor (Color, white) ; 

g.fillRect(0 i 0 , this . getWidth () , this .getHeight () ) ; 


g . aetColor (Color . green) ; 
g.flllOval (x,y , 40 , 40) ; 


Sharpen  your  pencil  (optional,  just  for 


X 


T 


" ihheri^  ^ Jp '£1 


fun] 


What  changes  would  you  make  to  the  x and  y coordinates  to  produce  the  animations  below? 
(assume  the  first  one  example  moves  In  3 pixel  increments) 


• 

• 

start 

finish 

• 

• 

start 

finish 

• 

• 

start 

finish 

xJi 

Y_ti 

X 

Y  

X 

Y 


1 


2 


3 


• 

• 

start 

finish 

• 

• 

start 

finish 

• 

• 

start 

finish 

X 

Y. 

X 

Y 


X 

Y 
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i 


* 


* 

Code  Kitcke 


n 


i 


beat  two 


beat  £<***  - 


Let’s  make  a music  video.  We’ll  use  Java-generated  random 
graphics  tkat  keep  time  witk  tke  musk  keats. 

Along  tke  way  we’ll  register  (and  listen  lor)  a new  kind  of 
non-GUI  event,  triggered  ky  tke  musk  itself. 


Remember,  tbi*  part  is  dll  optional-  But  we  tkink  its  §ood  tor  you 

And  you'll  like  it  And  you  d£n  use  it  to  impress  people. 

(Ok,  sure,  it  miabt  work  only  on  people  wko  are  really  easy  to  impress, 
but  still-) 
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OK,  maybe  not  a music  video,  but  we  mil  make 
a program  that  draws  random  graphics  on  the 
screen  with  the  beat  of  the  music.  In  a nutshell, 
the  program  listens  for  the  beat  of  the  music 
and  draws  a random  graphic  rectangle  with  each 
beat. 

That  brings  up  some  new  issues  for  us.  So  far, 
we’ve  listened  for  only  GUI  events,  but  now 
we  need  to  listen  for  a particular  kind  of  MIDI 
event.  Turns  out,  listening  for  a non-GUI  event  is 
just  like  listening  for  GUI  events:  you  implement 
a listener  interface,  register  the  listener  with  an 
event  source,  then  sit  back  and  wait  for  the  event 
source  to  call  your  event-handler  method  (the 
method  defined  in  the  listener  interface). 

The  simplest  way  to  listen  for  the  beat  of  the 
music  would  be  to  register  and  listen  for  the 
actual  MIDI  events,  so  that  whenever  the 
sequencer  gets  the  event,  our  code  will  get  it 
too  and  can  draw  the  graphic.  But...  there’s  a 
problem.  A bug,  actually,  that  won’t  let  us  listen 
for  the  MIDI  events  we ’re  making  (the  ones  for 
NOTE  ON). 

So  we  have  to  do  a little  work-around.  There 
is  another  type  of  MIDI  event  we  can  listen 
for,  called  a ControllerEvent.  Our  solution 
is  to  register  for  ControllerEvents,  and  then 
make  sure  that  for  every  NOTE  ON  event, 
there’s  a matching  ControllerEvent  fired  at 
the  same  ‘beat’.  How  do  we  make  sure  the 
ControllerEvent  is  fired  at  the  same  time?  We 
add  it  to  the  track  just  like  the  other  events!  In 
other  words,  our  music  sequence  goes  like  this: 

BEAT  1 - NOTE  ON,  CONTROLLER  EVENT 

BEAT  2 -NOTE  OFF 

BEAT  3 - NOTE  ON,  CONTROLLER  EVENT 
BEAT  4 -NOTE  OFF 
and  so  on. 

Before  we  dive  into  the  full  program,  though, 
let’s  make  it  a little  easier  to  make  and  add  MIDI 
messages/events  since  in  this  program,  we’re 
gonna  make  a lot  of  them. 


What  the  music  art  program 
needs  to  do: 

0 Make  a series  of  MIDI  messages/ 
events  to  play  random  notes  on  a piano 
(or  whatever  instrument  you  choose) 

0 Register  a listener  for  the  events 

0 Start  the  sequencer  playing 

Q Each  time  the  listener's  event 
handler  method  is  called,  draw  a 
random  rectangle  on  the  drawing 
panel,  and  call  repaint. 


We’ll  build  it  in  three  iterations: 

Q Version  One:  Code  that  simplifies  mak- 
ing and  adding  MIDI  events,  since  we'll 
be  making  a lot  of  them. 

0 Version  Two:  Register  and  listen  for 
the  events,  but  without  graphics. 

Prints  a message  at  the  command-line 
with  each  beat. 

£ Version  Three:  The  real  deal.  Adds 
graphics  to  version  two. 
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An  easier  way  to  wake 
messages  / events 

Right  now,  making  and  adding  messages  and 
events  to  a track  is  tedious.  For  each  message, 
we  have  to  make  the  message  instance  (in  this 
case,  ShortMessage)j  call  setMessageO,  make  a 
MidlEvent  for  the  message,  and  add  the  event 
to  the  track.  In  last  chapter's  code,  we  went 
through  each  step  for  every  message.  That 
means  eight  lines  of  code  just  to  make  a note 
play  and  then  stop  playing!  Four  lines  to  add  a 
NOTE  ON  event,  and  four  lines  to  add  a NOTE 
OFF  event 

ShortMessage  a = new  ShortMessage () ; 

a.  satMessage (144,  1,  note,  100); 

MidlEvent  noteOn  = new  MidlEvent  (a,  1)  ; 
track. add (noteOn)  ; 

ShortMessage  b = new  ShortMessage  {) ; 

b,  setMess&ga (128 , 1,  note,  100); 

MidlEvent  noteOff  = new  MidlEvent (b,  16)  ; 
track, add (no teOff)  ; 


Things  that  have  to  happen  for 
each  event: 

^ Make  a message  instance 

ShortMessage  first  = new  ShortMessage  ()  ; 

@ Call  setMessage()  with  the  instructions 

first . setMessage (192,  1,  instrument,  0) 

$ Make  a MidlEvent  instance  for  the  message 

MidlEvent  noteOn  = new  MidlEvent  (first,  1)  ; 

4^)  Add  the  event  to  the  track 

track,  add  (noteOn)  ; 


Let’s  build  a static  utility  method  that 
makes  a message  and  returns  a MidlEvent 


L.  TV  evtnf  'tile' 

|V,e  £°'*r  *r<P*'er'  WW8J<I  fhii 

«happe,  3 


public  static  MidlEvent  makeEvent (int  comd,  int  chan,  int  one,  int  two,  int  tick)  ( 
Hldl.Bv.nt  nvnnt  - nnll ; ,itt  f 


tty  t 

ShortMessage  a = new  ShortMessage () ; 
a, setMessage (comd,  chan,  one,  two); 
event  = new  MidlEvent  (a,  tick)  ; 


**'  “■*  w»3 


) catch  (Exception  e)  { ) 

tnturn  —nt, ^ ^ ± ,|| 


oZAtA  VNitk  t hi 
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Example:  how  to  use  the  new  static 
makeEventO  method 

There’s  no  event  handling  or  graphics  here,  just  a sequence  of  15 
notes  that  go  up  the  scale.  The  point  of  this  code  is  simply  to  learn 
how  to  use  our  new  makeEvent()  method.  The  code  for  the  next 
two  versions  is  much  smaller  and  simpler  thanks  to  this  method. 


import  javax . sound . midi . * ; 

public  class  MiniMusicPlayerl  { 


d°»'i  £ 


***  ihe 


public  static  void  main (String []  args)  { 


try  ( 

Sequencer  sequencer  = MidiSystem. getSequencer  ()  ; 
sequencer . open ( ) ; ^ 


3 


Sequence  seq  = new  Sequence  (Sequence. PPQ,  4)  ; ^ makc  a se<\uende 

Track  track  = seq . createTrack  ( ) ; and  a trad k 

for  (int  i * 5;  i < 61;  i+=  4)  { make  a bundk  o-f  events  to  make  tke  notes  keef 

going  up  ('from  piano  note  5 to  pidno  note 


track. add (makeEvent (144 ,1 ,i, 100 ,i) ) , 
track . add  (makeEvent  (128,l,i,100,i  + 


2)) 


dal! 


} //  end  loop 


rfc  ii 


running 


sequencer . setSequence (seq) ; 
sequencer . setTempoInBEM( 220) 
sequencer . start ( ) ; 

} catch  (Exception  ex)  (ex.printStackTrace () ; } 
//  close  main 


dU  ^ makeEventO  j l 
m<«age  and  eveni  li Z k>  wake  -the 

Midi^en-t  teiur  jfy*  ***  *resu^  (the 

the  W ni  t u?-r?ke£''‘’'tO)  l 


public  static  MidiEvent  makeEvent  (int  comd,  int  chan,  int  one,  int  two,  int  tick)  { 
MidiEvent  event  = null; 
try  { 

ShortMessage  a = new  ShortMessage(); 
a.  setMes sage  (corad,  chan,  one,  two); 
event  = new  MidiEvent  (a,  tick)  ; 

} catch (Exception  e)  ( ) 
return  event; 

} 

) //  close  class 
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Version  Two:  registering  and  getting  ControilerEvents 


import  javax.  sound. midi  >* ; 
public  class  MiniMusicPlayer2  Inplf 


vT 


VJe  h>  $<*  C^trollereveoU 
^ i*?Wrrt  ti»e  li*W  mterta6« 


mts  Control  ler&vvntXristener  { 


public  static  void  main (String []  arga)  ( 


MiniMusicPlayer2  mini  = new  MiniMusicPlayer2 () ; 
mini* go ()  ; 


} 


public  void  go()  { 
try  { 

Sequencer  sequencer  = MidiSystem . getSequencer () 
sequencer . open ( ) ; 


r U -the 

tout**  w Ti  4U  takes  the 

TV  evtr.t v-eyri^M 


int[]  eventsIWant  = (127}; 

sequencer  * addControllerEventListener  (this , events  IKant)  ; 


Sequence  seq  = new  Sequence (Sequence . PPQ,  4) 
Track  track  = seq* createTrack 0 ; 


for  (int  i = 5;  i < 60;  i+=  4)  { 

track. add (makeEvent (144 , 1 ,1,100,1) ) 


track  - add  (makeEvent  (176 , 1 , 127 , 0,  i)  ) ; 


track.add(make£vent(128,l,i,100,i  + 2)); 
) //  end  loop 

sequencer.  setSequence  (seq)  ; 
sequencer .setTempoInBFM (220) ; 
sequencer . start ( ) ; 

) catch  (Exception  ex)  (ex .prints tackTraca () ; ) 
) //  close 


public  void  con tr o IChange ( Shortness age  event) 
System, out .prin tin ("la") ; 

> 


Mete  s how  w«  pith  up  l,  , 

*7'S^£x£rt 

■v'-rv  ««rt  ** 


ev*ivt>  ** ' 


^Ytn- 


public  Midi Event  makeEvent (int  eorad,  int  chan,  int  one,  int  two,  int  tick)  ( 
MidiEvent  event  =*  null; 
try  { 

ShortMaasage  a =■  new  ShortMessage () ; 
a.  setMessage  (comd,  chan,  one,  two); 
event  = new  MidiEvent (a,  tick) ; 


) catch (Exception  e)  { ) 
return  event; 


Code  that's  different  from  the  previous 
version  is  highlighted  in  gray,  (and  we're 
not  running  it  oil  within  main()  this  time) 


) 

} //  close  class 
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Version  Three:  drawing  graphics  in  time  with  the  music 

This  final  version  builds  on  version  two  by  adding  the  GUI  parts.  We  build  a 
frame,  add  a drawing  panel  to  it,  and  each  time  we  get  an  event,  we  draw  a 
new  rectangle  and  repaint  the  screen.  The  only  other  change  from  version 
two  is  that  the  notes  play  randomly  as  opposed  to  simply  moving  up  the 
scale. 

The  most  important  change  to  the  code  (besides  building  a simple  GUI) 
is  that  we  make  the  drawing  panel  implement  the  GontrollerEventListener 
rather  than  the  program  itself.  So  when  the  drawing  panel  (an  inner  class) 
gets  the  event,  it  knows  how  to  take  care  of  itself  by  drawing  the  rectangle. 

Complete  code  for  this  version  is  on  the  next  page. 


The  drawing  panel  inner  class: 


^ — TV*  dr aWmg  ?a"e' ,s  3 'lS^e>'e'r 

class  MyDrawPanel  extends  JPanel  implements  ControllerEventListener  { 

boolean  msg  = false;  p—  Wesei  3 -flag  to  false,  and  well  set  it 

to  true  only  when  we  get  an  event 

public  void  controlChange (ShortMessage  event)  { 
msg  = true; 

repaint  () ; t— — P*  3°^  a»  «w«>t  so  we  set  the  flag  to 
J true  and  tall  refaintO  3 


public  void  paintCoraponent (Graphics  g)  { 
if  (msg)  { > 

^7*  Kave  3 ^33  b««use  OTm  things  might  tri 
3hd  we  want  to  faint  OH O/  when  there’  - * 9l  " 

Graphics2D  g2  = (Graphics2D)  g; 


3 Controller, 


pr  a vepaintO, 
vent 


int  r = (int)  (Math . random ()  * 250); 
int  gr  = (int)  (Math. random ()  * 250)  ; 

int  b = (int)  (Math . random ( ) * 250);  The  rest  is  d©de  to  generate 

a random  to  lor  and  paint  a 

g . setColor  (new  Color  (r , gr , b) ) ; semi-random  tedtanjle- 

int  ht  = (int)  ( (Math. random ()  * 120)  + 10); 
int  width  = (int)  ( (Math . random ( ) * 120)  + 10); 
int  x = (int)  ( (Math . random ( ) * 40)  + 10); 
int  y = (int)  ( (Math. random ()  * 40)  + 10); 
g . fillRec t (x , y , ht , width)  ; 
msg  = false; 


} //  close  if 
} //  close  method 
) //  close  inner  class 
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MiniMusicPlayer3  code 


import  j avax . sound . midi  . * ; 
import  java.io.*; 
import  j avax . swing . * ; 
import  j ava . awt . * ; 

public  class  MiniMusicPlayer3 


your  pencil 


This  is  the  complete  code  listing  for  Version 
Three.  It  builds  directoy  on  Version  Two.  Try 
to  annotate  it  yourself,  without  looking  at  the 
previous  pages. 


static  JFrame  f = new  JFrame ( "My  First  Music  Video"); 
static  MyDrawPanel  ml; 


public  static  void  main (String []  args)  { 

MiniMusicPlayer3  mini  = new  MiniMusicPlayer3 () ; 
mini . go ( ) ; 

} //  close  method 


public  void  setUpGui()  { 
ml  = new  MyDrawPanel ( ) ; 
f , setContentPane (ml) ; 
f .setBounds (30,30,  300,300) ; 
f .setVisible(true)  ; 

) //  close  method 

public  void  go()  { 
setUpGui ( ) ; 

try  { 

Sequencer  sequencer  = MidiSystem. getSequencer  ()  ; 
sequencer . open ( ) ; 

sequencer , addControllerEventListener (ml , new  int [ ] { 127 } ) ; 
Sequence  seq  = new  Sequence (Sequence. PPQ,  4) ; 

Track  track  = seq. createTrack ( ) ; 

int  r = 0; 

for  (int  i = 0;  i < 60;  i+=  4)  { 

r = (int)  ( (Math . random ( ) * 50)  + 1) ; 
track . add (makeEvent (144,l,r,100,i))  ; 
track . add (makeEvent (176 , 1 , 127 , 0 , i ) ) ; 
track. add (makeEvent (128 , 1 ,r, 100 ,i  + 2)); 

} //  end  loop 

sequencer. setSequence (seq) ; 
sequencer . start ( ) ; 
sequencer . setTempoInBPM(120) ; 

} catch  (Exception  ex)  { ex. prints tackTrace () ;} 

) //  close  method 
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A bunch  of  Java  hot-shots,  in  full  costume,  are  playing  the  party  game 'Who 
am  I?"  They  give  you  a clue,  and  you  try  to  guess  who  they  are,  based  on 
what  they  say.  Assume  they  always  tell  the  truth  about  themselves.  If  they 
happen  to  say  something  that  could  be  true  for  more  than  one  guy,  then 
write  down  all  for  whom  that  sentence  applies.  Fill  In  the  blanks  next  to  the 
sentence  with  the  names  of  one  or  more  attendees. 

Tonight's  attendees: 

Any  of  the  charming  personalities  from  this  chapter  just 
might  show  up! 

I got  the  whole  GUI,  In  my  hands.  

Every  event  type  has  one  of  these.  

The  listener's  key  method.  

This  method  gives  JFrame  its  size.  

You  add  code  to  this  method  but  never  call  it  

When  the  user  actually  does  something,  it’s  an , 

Most  of  these  are  event  sources,  

I carry  data  back  to  the  listener.  

An  addXxxListener( ) method  says  an  object  Is  an . 

How  a listener  signs  up.  

The  method  where  all  the  graphics  code  goes.  

I’m  typically  bound  to  an  instance.  

The  ‘g’  In  (Graphics  g),  Is  really  of  class.  

The  method  that  gets  paintComponent( ) rolling.  

The  package  where  most  of  the  Swingers  reside.  
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import  javax.swing.*; 
import  java. awt. event.*; 
import  java.avrt.*; 

class  InnerButton  { 

JFrame  frame; 

JButton  b; 


BE  the  compiler 


The  Java  file  an  this  page  represents  a 
complete  source  file.  Your  job  is  to  play 
compiler  ami  determine  whether  this  file 
will  compile.  If  it  won’t  compile,  how 
would  you  fix  it,  and  if  it  does 
compile,  what  would  it  do? 


public  static  void  main (String  ()  args)  { 
InnerButton  gui  = new  InnerButton( ) ; 
gui.gof); 

> 

public  void  go< ) { 
frame  - new  JFrame(); 
frame, setDefaultCloseOperation( 

JFrame . EXIT_ON_CLO£E ) ; 

b = new  JButton  (^A17); 
b.addActionListener{ ) ; 

frame . getContentPane ( ) . add ( 

BorderLayout . SOUTH , b ) ; 
f rame.setSi2e( 200,1 00 ) ; 
frame.setVisible(true) ; 

} 

class  BListener  extends  ActionListener  { 

public  void  actionPer formed (ActionEvent  e)  { 
if  (b.getText( ) .equals ("A") ) { 
b.setText("B") ; 

} else  { 
b.setText^A") ; 

) 

} 


> 
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Exercise  Solutions 


Who  am  I? 


I got  the  whole  GUI,  in  ray  hands. 

Every  event  type  has  one  of  these. 

The  listener’s  key  method. 

This  method  gives  JFrame  its  size. 

You  add  code  to  this  method  but 
never  call  it. 

When  the  user  actually  does 
something,  it's  an 

Most  of  these  are  event  sources. 

1 cany  data  back  to  the  listener. 

An  addXxxListener( ) method 
says  an  object  is  an 

How  a listener  signs  up. 

The  method  where  all  the 
graphics  code  goes. 

Tm  typically  bound  to  an  instance. 

The  ‘g’  in  (Graphics  g),  is 
really  of  this  class. 

The  method  that  gets 
pamtComponent( ) rolling. 

The  package  where  most  of  the 
Swingers  reside. 


JFrame 

listener  interface 
actionPerf  ormed( ) 
setSize(  ) 

paintComponent( ) 

event 

swing  components 
event  object 

event  source 

addActionListener( ) 

paintComponen+( ) 
inner  class 

Graphics^d 

repornt( ) 

javax.swing 


BE  comber 


import  javax. swing.*; 
import  java.awt. event**; 
import  java.awt.*; 

class  InnerButton  { 

JFrame  frame; 

JButton  b; 

public  static  void  main(String  [1  args)  { 
InnerButton  gui  - new  InnerButtonf ) ; 
gui.go(); 

) 

public  void  go{ ) { 
frame  = new  JFrame(); 
frame » setDef aultCloseOperation ( 

JFrame >EXIT_ON_CLOSE) ; 


Once  this  code 
is  fixed,  it  will 
create  a GUI  with 
a button  that 
toggles  between 
A and  B when  you 
click  it. 


The  addActionListener( ) 
method  takes  a class  that 
implements  the  ActionLis- 
tener  interface 


b = new  JButton ("A"); 
b . addActionX.istener{  rnwHittemrO  u 

frame *getContentPane( ) .add( 

BorderLayout.SODTH,  b); 
frame. setSize( 200, 100 J ; 
frame * setVisible ( true ) ; 

} 

class  BListener  Implement*  ActionListener  { 
public  void  actionPer formed (ActionEvent  e)  { 
if  (b.getText(  J .equals ("A")  J { 
b. setText( "B") ; 

} else  { 
b.$etText("AB) ; 

1 

) 

} 

) 


ActionListener  is  an 
interface,  interfaces 
are  implemented,  not 
extended 
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p<^]  puzz]e 


The  Axrtazing,  Shrinking,  Blue 
Rectangle. 


J 


import  javax.  swing.  * ; 
import  java.awt.*; 
public  class  Animate  { 
int  x - 1; 
int  y = 1; 

public  static  void  main  (String[]  args)  { 
Animate  gui  = new  Animate  ( ) ; 
gui . go ( ) ; 

) 

public  void  go()  { 

JFrame  frame  = new  JFrame(); 
frame . setDef aultCloseOperation ( 

JFrame . EXIT_ON_CLOSE ) ; 

MybrawP  drawP  = new  MyDrawPO; 
frame. getContentPane( ) .add (drawP) ; 

f rame.setSize(500,270)  ; 

frame. setVisible(true) ; 

for  (int  i = 0;  i < 124;  i- M-/x++/y++  ) { 

X++? 

drawP.repaint(); 

try  { 

Thread . sleep ( 50 ) ; 

} catch (Exception  ex)  { } 

} 

> 

class  MyDrawP  extends  JPanel  { 

public  void  paintComponent (Graphics  g ) { 
g.setColor(Color.white); 
g.fillRect(0 ,0,500, 250); 
g.setColor(Color.blue); 
g.fillRect(x,y,500-x*2,250-y*2); 

} 

} 

> 
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Why  won’t 

the  ball  go  where  I wont 
it  to  go?  (like,  smack  in  Suzy 
Smith’s  face)  Fve  gotta  learn 
l to  control  it. 


Work  on  Your 
Swing 


Swing  is  easy.  Unless  you  actually  care  where  things  end  up  on  the  screen.  Swing  code 
looks  easy,  but  then  you  compile  it,  run  it,  look  at  it  and  think, "'hey,  that's  not  supposed  to  go 
there ” The  thing  that  makes  it  easytocodels  the  thing  that  makes  It  hard  to  con  fro/— the 
Layout  Manager.  Layout  Manager  objects  control  the  size  and  location  of  the  widgets  in  a 
Java  GUI. They  do  a ton  of  work  on  your  behalf,  but  you  won't  always  like  the  results. You  want 
two  buttons  to  be  the  same  size,  but  they  aren't.  You  want  the  text  field  to  be  three  inches  long, 
but  It's  nine.  Or  one.  And  under  the  label  instead  of  nemo  It.  But  with  a little  work,  you  can  get 
layout  managers  to  submit  to  your  will.  In  this  chapter,  we'll  work  on  our  Swing  and  in  addition 
to  layout  managers,  well  learn  more  about  widgets,  We'll  make  them,  display  them  (where  we 
choose),  and  use  them  In  a program.  It's  not  looking  too  good  for  Suzy. 
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Swing  components 

Component  is  the  more  correct  term  for  what  we've  been  calling  a xoidgeL 
The  things  you  put  in  a GUI.  The  things  a user  sees  and  interacts  witk  Text 
fields,  buttons,  scrollable  lists,  radio  buttons,  etc.  are  all  components.  In 
fact*  they  all  extend  javax.  swing.  JComponent. 

Components  can  be  nested 

In  Swing,  virtually  all  components  are  capable  of  holding  other 
components.  In  other  words,  you  can  stick  just  about  anything  into  anything 
else  But  most  of  the  dme,  you'll  add  user  interactive  components  such  as 
buttons  and  lists  into  background  components  such  as  frames  and  panels. 

Although  it's  possible  to  put,  say,  a panel  inside  a button,  that's  pretty 
weird,  and  won't  win  you  any  usability  awards. 

With  the  exception  of  JFrame,  though,  the  distinction  between  interactive 
components  and  background  components  is  artificial.  AJPanel,  for 
example,  is  usually  used  as  a background  for  grouping  other  components, 
but  even  a JPanel  can  be  interactive.  Just  as  with  other  components,  you 
can  register  for  the  JPanel's  events  including  mouse  clicks  and  keystrokes. 

Four  steps  to  making  a GUI  (review) 

£ Make  a window  (a  JFrame) 

JFrame  frame  >=  new  JFrame  ()  ; 

g Make  a component  (button,  text  field,  etc.) 

JButton  button  new  JBut  ton  ("elide  me"); 

g Add  the  component  to  the  frame 

frame. getContentP&ne () . add (Border Layout. EAST,  button) ; 

g Display  it  (give  it  a size  and  make  it  visible) 

frame. setSize (300 ,300) ; 
frame  . setVisible  (true)  ; 

Put  interactive  components:  Into  background  components: 


P thooM 

|ThH  Is  a text  flcteTl  2 


A wi  dget  is  tecknically 
a Swing  Component. 
Almost  every  tiling 
you  can  stick  in  a 
GUI  extends  from 

java  xjswing.  JComponent. 
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Layout  Managers 

A layout  manager  is  a Java  object  associated 
with  a particular  component,  almost  always  a 
background  component  The  layout  manager 
controls  the  components  contained  within  the 
component  the  layout  manageris  associated 
with.  In  other  words,  if  a frame  holds  a panel, 
and  the  panel  holds  a button,  the  panel's  layout 
manager  controls  the  size  and  placement  of 
the  button,  while  the  frame's  layout  manager 
controls  the  size  and  placement  of  the 
panel.  The  button,  on  the  other  hand, 
doesn't  need  a Layout  manager  because  the 
button  isn't  holding  other  components. 

If  a panel  holds  five  things,  even  if  those 
five  things  each  have  their  own  layout 
managers,  the  size  and  location  of  the  five 
things  in  the  panel  are  all  controlled  by  the 
panel's  layout  manager.  If  those  five  things, 
in  turn,  hold  other  things,  then  those  other 
things  are  placed  according  to  the  layout 
manager  of  the  thing  holding  them. 


As  a layout  manager. 

I’m  in  charge  of  the  size 
and  placement  of  your  components. 

In  this  6UI,  I'm  the  one  who  decided 
how  big  these  buttons  should  be,  and 
where  they  are  relative  to  each 
other  and  the  frame. 


When  we  say  hold  we  really  mean  add  as  in,  a 
panel  holds  a button  because  the  button  was 
added  to  the  panel  using  something  like: 

aiyPanel . add  (button)  ; 

Layout  managers  come  in  several  flavors,  and 
each  background  component  can  have  its  own 
layout  manager.  Layout  managers  have  their 
own  policies  to  follow  when  building  a layout 
For  example,  one  layout  manager  might  insist 
that  all  components  in  a panel  must  be  the  same 
dtze,  arranged  in  a grid,  while  another  layout 
manager  might  let  each  component  choose  its 
own  size,  but  stack  them  vertically  Here's  an 
example  of  nested  layouts: 

JPanel  panelA  = new  JPanel ( ) ; 


$£&•*** 


hi  of  pan4|  g 


Panel  A 


JPanel  panels  =*  new  JPanel  ( ) ; 
panelB  .add  (new  JButton  ("button  1")  ) 
panelB.add(new  JBut ton ("button  2") ) 
panelB.add(new  JButton ("button  3")) 
panelA.add(panelB) ; 


. - u monger  has  nu  i to 

say  aUUKe  W kU  TKe 
, , Vt*  Hi  layout 

„ T,,  il  tdoei  ionhroi  y 

wild  *rtXih  thos«  added  tomponihU  3 
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How  does  the  layout  manager  decide? 


Different  layout  managers  have  different  policies  for  arranging 
components  (like,  arrange  in  a grid,  make  them  all  the  same  size, 
stack  them  vertically,  etc.)  but  the  components  being  layed  out  do 
get  at  least  some  small  say  in  the  matter.  In  general,  the  process  of 
laying  out  a background  component  looks  something  like  this: 


A layout  scenario: 

0 Make  a panel  and  add  three  buttons  to  it. 

® The  panel's  layout  manager  asks  each  buttorthow  big 
that  button  prefers  to  be. 


Let's  see  here...  the 
first  button  wants  to  be 
30  pixels  wide,  and  the  text  field 
needs  50,  and  the  frame  is  200  pixels 
wide  and  I’m  supposed  to  arrange 
everything  vertically... 


® The  panel's  layout  manager  uses  its  layout  policies  to  decide 
whether  it  should  respect  all,  part,  or  none  of  the  buttons' 
preferences. 

@ Add  the  panel  to  a frame. 

® The  frame's  layout  manager  asks  the  panel  how  big  the  panel 
prefers  to  be. 

<§)  The  frame's  layout  manager  uses  its  layout  policies  to  decide 
whether  it  should  respect  all,  part,  or  none  of  the  panel's 
preferences. 


O 

o 


Afferent  layout  managers  have  different  polieles 


Some  layout  managers  respect  the  size  the  component  wants  to 
be.  If  the  button  wants  to  be  BO  pixels  by  50  pixels,  that's  what  the 
layout  manager  allocates  for  that  button.  Other  layout  managers 
respect  only  part  of  the  component's  preferred  size.  If  the  button 
wants  to  be  30  pixels  by  50  pixels,  it’ll  be  30  pixels  by  however 
wide  the  button's  background  panel  is.  Still  other  layout  managers 
respect  the  preference  of  only  the  largest  of  the  components 
being  layed  out,  and  the  rest  of  the  components  in  that  panel 
are  all  made  that  same  size.  In  some  cases,  the  work  of  the  layout 
manager  can  get  very  complex,  but  most  of  the  dme  you  can 
figure  out  what  the  layout  manager  will  probably  do,  once  you  get 
to  know  that  layout  manager's  policies. 
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BorderLayout 

A BorderLayout  manager  divides  a background 
component  into  five  regions.  You  can  add  only  one 
component  per  region  to  a background  controlled 
by  a BorderLayout  manager.  Components  laid  out 
by  this  manager  usually  don’t  get  to  have  their 
preferred  size.  BorderLayout  Is  the  default  layout 
manager  for  a frame! 


O'* 


FlowLayout 

A FlowLayout  manager  acts  kind  of  like  a word 
processor,  except  with  components  instead  of 
words.  Each  component  is  the  size  it  wants  to  be, 
and  they're  laid  out  left  to  right  in  the  order  that 
they're  added,  with  “word-wrap"  turned  on.  So 
when  a component  won't  fit  horizontally,  it  drops 
to  the  next  "line"  in  the  layout.  FlowLayout  Is  the 
default  layout  manager  for  a panel  I 


ao 

0^  l — ~S\ 

IsD 
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*utd  Mi 
r^ih9  to  a 

***  W when  Kttdtd 


BoxLayout 

A BoxLayout  manager  is  like  FlowLayout  in  that 
each  component  gets  to  have  its  own  size,  and 
the  components  are  placed  in  the  order  in  which 
they're  added.  But,  unlike  FlowLayout,  o BoxLayout 
manager  can  stack  the  components  vertically  (or 
horizontally,  but  usually  we're  just  concerned  with 
vertically).  It's  like  a FlowLayout  but  instead  of 
having  automatic  ‘component  wrapping',  you  can 
insert  a sort  of  "component  return  key  and  force 
the  components  to  Start  a new  line. 


\ 


tenements 

to  bottom 


added  , 
or*?**  'me 
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BorderLayout  cares 
about  five  regions: 

east,  west,  north, 
south,  and  center 


Let’s  add  a button  to  the  east  region: 

import  javax . swing . * ; , 

import  java. awt.*;  ^ ^aricrLi'i^  ^ 

public  class  Buttonl  { 

public  static  void  main  (StxingH  axgs)  { 
Buttonl  gui  - new  Buttonl (); 

gui.goO  ; 


public  void  go ()  { .c  rt 

JFrame  frame  = new  JFrame ()  ; ' 

JButton  button  = new  JButton ("click  me");  ^ 
f rame . getContentPane ( ) . add (BorderLayout . EAST , button) ; 
frame . setSize (200  y 200) ; 
frame  * setVisible (true) ; 
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Watch  what  happens  when  we  give 
the  button  more  characters... 


public  void  go()  ( 

JFrame  frame  - new  JFrame  0 ; ^ 

JButton  button  = new  JButton ("click  like  you  mean  it"); 
frame . getContentPane () . add (Border Layout . EAST,  button) ; 
frame . setSize (200, 200) ; 
frame . setvisible (true) ; 
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border  layout 


Let’s  try  a button  in  the  NORTH  region 

public  void  go ()  { 

JFrame  frame  = new  JFrame  0; 

JButton  button  = new  JButton. ("There  is  no  spoon.  . . ")  ; 

frame . getContentPane ( ) - add (BorderLayout . NORTH,  button) ; 
frame. setSize (200, 200) ; 
frame . setvisible (true) ; 


Now  let’s  make  the  button  ask  to  be  taller 

How  do  we  do  that?  The  button  is  already  as  wide 
as  it  can  ever  be— as  wide  as  the  frame.  But  we 
can  try  to  make  it  taller  by  giving  it  a bigger  font. 


public  void  go()  ( 

JFrame  frame  = new  JFrame  (S; 

JButton  button  = new  JButton  ("Click  This!1');  ^ 

Font  bigFont  = new  Font ("serif".  Font. BOLD,  28); 
button.setFont(bigFont) ; 

frame . getContentPane ( ) .add (BorderLayout .NORTH,  button) 
frame . setSize (200, 200) ; 

frame . setvisible (true) ; 

> [see 

r Click  This!  ) <r- 
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But  wkat  kappens 
in  tke  center  region? 


The  center  region  gets  whatever1*  leftl 

(except  in  one  special  case  we'll  look  at  later) 

public  void  go ( ) { 

JFrame  frame  - new  JFrameO; 


JButton  east  - new  JButton ("East" ) ; 
JButton  west  = new  JButton ("West") ; 
JButton  north  = new  JButton ("North" ) ; 
JButton  south  = new  JButton ("South") ; 
JButton  center  = new  JButton ("Center") ; 


frame , getContentPane () . add (BorderLayout , EAST,  east) ; 
frame. getContentPane () . add (BorderLayout .WEST,  west) ; 
frame . getContentPane () . add (BorderLayout .NORTH,  north) ; 
frame . getContentPane 0 .add (BorderLayout > SOUTH,  south) ; 
frame . getContentPane () . add (BorderLayout .CENTER,  center) ; 


frame . aetSize (300,300) 
frame . setvisible (true) 


x ,h 

„ „ l,  hse 


iOC  pi**k 
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□ O ' 

0^  I vl 

ls_J 


FlowLayout  cares 
about  the  flow  of  the 
components: 

left  to  right,  top  to  bottom,  in 
the  order  they  were  added. 


Let’s  add  a panel  to  the  east  region: 


A JPanel’s  layout  manager  is  FlowLayout,  by  default.  When  we  add 
a panel  to  a frame,  the  size  and  placement  of  the  panel  is  Still 
under  the  BorderLayout  manager's  control.  But  anything  inside  the 
panel  (in  other  words,  components  added  to  the  panel  by  coifing 
panel . add  (aComponent) ) are  under  the  panel's  FlowLayout 
manager's  control.  Well  start  by  putting  an  empty  panel  in  the  frame's 
east  region,  and  on  the  next  pages  we'IJ  add  things  to  the  panel. 


Import  javax . awing.  * ; 
import  java.awt.*; 

public  class  Panel 1 { 

public  static  void  main  (String!] 
Panell  gui  = new  PaaellO; 
gui.go()  ; 

) 


} 


pawl  yiy  so  v*  see 
Uf  whew  i-t  is  or,  -the  Wi~,e. 


public  void  go()  { 

JFrame  frame  =»  new  JFrame () ; 

JPanel  panel  - new  JPanel () ; 
panel . setBackground (Color . darXGray) ; 
frame . getContentPane () . add ( Border Layout . EAST , panel) ; 
frame . setSize (200  , 200) ; 
frame . setvisible  (true)  ; 
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Let's  add  a button  to  the  panel 


m<i  ** 


public  void  go ( ) { 

JFrame  frame  - new  JFraxneO; 

JPanel  panel  = new  JPanel 0 ; 

panel , setBackground  (Color . darkGray)  ; /loo  v1*-  ^ — * -pi  s — ' 

?a*A  to  to*  ^ TJl*  a.d  toe 

JButton  button  - new  JButton  ("shock  me7')  ; UUJ^^rr^UtoeY^ 

, ljuowt  (wa 

panel . add (button) ; C ^ * 

frame . getContentPane  () ■ add (BorderLayout . EAST,  panel) ; 


frame . sets ite (250,200) ; 
frame . setVisible (true) ; 


n>e  panel  expanded/ 

And  toe  button  ito 
P^+«red  iiz<  j„  totK 
d.n.ensiow  bedawe'lhe  panel 

J*V/,oto  layout,  and  toe 


The  frame's  The  panel’s 


BorderLayout  manager  FlowLayout  manager 
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What  happens  if  we  add  TWO  buttons 
to  the  panel? 


public  void  go ( ) { 

JFrarne  frame  - new  JFrarne  (); 

JPanel  panel  = new  JPanelO; 

panel , setBackground (Color .darkGray) ; 

JButton  button  = new  JButton  ("shock  me'')  ; 
JButton  buttonTwo  = new  JButton ("bliss") ; 


TV/O^tW 


panel . add  (button)  ; 
panel . add (buttonTwo) 


->dd  Both  & ^ 


P 


frame.getContentPaneO  . add (BorderLayout > EAST,  panel) ; 
frame > setSize (250, 200) ; 
frame . setvisible (true) ; 


what  we  wanted^ 


what  we  got : 


If  the  code  above  were  modified  to  the  code  below, 
what  would  the  GUI  look  like? 


JButton  button  = new  JButton ("shock  me"); 
JButton  buttonTwo  = new  JButton ("bliss") ; 
JButton  buttonThree  « new  JButton ("huh?") ; 
panel . add (button) ; 
panel .add (buttonTwo) ; 
panel . add (buttonThree) ; 


Draw  what  you 
think  the  GUI  would 
look  like  If  you  ran 
the  code  to  the  left. 

(Then  try  It!) 
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Q 


BoxLayout  to  the  rescue! 

It  keeps  components 
stacked,  even  if  there’s  room 
to  put  them  side  by  side. 


Unlike  FlowLayout,  BoxLayout  can  force  a 
‘new  line’  to  make  the  components  wrap  to 
the  next  line,  even  If  there’s  room  for  them 
to  fit  horizontally. 

Bert  now  you'll  have  to  change  the  panel's  layout  manager  from  the 
default  FlowLayout  to  BoxLayout. 


public  void  go()  { 

JFrame  frame  = new  JFrameO; 

JPanel  panel  = new  JPanel  (); 
panel , setBackground (Color .darkGray) 


panel . setLayout  (new  BoxLayout  (panel , BoxLayout . Y-AXIS) ) 


JButton  button  - new  JButton ("shock  me"); 
JButton  buttonTwo  = new  JButton ("bliss") ; 
panel . add (button) ; 
panel -add (buttonTwo) ; 

frame . getCon tent Pane ( ) . add (BorderLayout . EAST, 
frame -setSize (250,200) ; 
frame . setvisible (true) ; 


BoxLsy^  Unfntt,, 


Jxi,  ic  u JM  * 
Hick;, 
panel) ; 


^ Yjiyis  i 


or  3 


<sA  . LSfr  the 


So -the 

y00"1 

V m t- 
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How  come  you  can't  add  directly  to  a frame  the  way 
you  can  to  a panel? 


A JFrame  Is  special  because  it's  where  the  rubber 
meets  the  road  In  making  something  appear  on  the  screen. 
While  all  your  Swing  components  are  pure  Java,  a JFrame 
has  to  connect  to  the  underlying  OS  In  order  to  access  the 
display.  Think  of  the  content  pane  as  a 100%  pure  Java  layer 
that  sits  on  top  of  the  JFrame.  Or  think  of  it  as  though  JFrame 
is  the  window  frame  and  the  content  pane  1$  the...  glass.  You 
know,  the  window  pane.  And  you  can  even  swap  the  content 
pane  with  your  own  JPanel,to  make  yourJPanel  the  frame's 
content  pane,  using, 

myFrwne . setContantP&ne (my Panel) ; 


% Can  I change  the  layout  manager  of  the  frame? 
What  If  I want  the  frame  to  use  flow  Instead  of  border? 


^\lThe  easiest  way  to  do  this  is  to  make  a panel,  build 
the  GUI  the  way  you  want  In  the  panel,  and  then  make  that 
panel  the  frame's  content  pane  using  the  code  In  the  previ- 
ous answer  (rather  than  using  the  default  content  pane). 

Q?  What  tf  I want  a different  preferred  size?  Is  there  a 
setSIzeO  method  for  components? 

.^lYes,  there  Is  a $etSlze(),  but  the  layout  managers  will 
Ignore  It.  There's  a distinction  between  the  preferred  size  of 
the  component  and  the  size  you  want  It  to  be. The  preferred 
size  Is  based  on  the  size  the  component  actually  needs 
(the  component  makes  that  decision  for  Itself  J.The  layout 
manager  calls  the  component's  getPreferredSIzeO  method, 
and  that  method  doesn't  core  If  you've  previously  called 
setSIzeO  on  the  component. 


Can't  I just  put  things  where  I want  them?  Can  I turn 
the  layout  managers  off? 

Yep.  On  a component  by  component  basis,  you  can  call 
aetLayout(null)  and  then  it's  up  to  you  to  hard-code 
the  exact  screen  locations  and  dimensions.  In  the  long  run, 
though,  It's  almost  always  easier  to  use  layout  managers. 


BULLET  POINTS  

■ Layout  managers  control  the  size  and  location  of 
components  nested  within  other  components. 

■ When  you  add  a component  to  another  component 
(sometimes  referred  to  as  a background  component, 
but  that’s  not  a technical  distinction),  the  added 
component  is  controlled  by  the  layout  manager  of  the  i 
background  component 

■ A layout  manager  asks  components  for  their 
preferred  size,  before  making  a decision  about 
the  layout.  Depending  on  the  layout  manager's 
policies,  it  might  respect  all,  some,  or  none  of  the 
component's  wishes. 

■ The  BorderLayout  manager  lets  you  add  a 
component  to  one  of  five  regions.  You  must  specify 
the  region  when  you  add  the  component,  using  the 
following  syntax: 

add (BorderLayout . EAST,  panel ) ; 

■ With  BorderLayout  components  in  the  north  and 
south  get  their  preferred  height  but  not  width. 
Components  in  the  east  and  west  get  their  preferred 
width,  but  not  height  The  component  in  the  center 
gets  whatever  is  left  over  (unless  you  use  pack  ( ) ). 

■ The  packO  method  Is  like  shrink-wrap  for  the 
components;  it  uses  the  foil  preferred  size  of  the 
center  component  then  determines  the  size  of  the 
frame  using  the  center  as  a starting  point,  building 
the  rest  based  on  what’s  in  the  other  regions. 

■ FlowLayout  places  components  left  to  right,  top  to 
bottom,  In  the  order  they  were  added,  wrapping  to  a 
new  line  of  components  only  when  the  components 
won't  fit  horizontally. 

■ FlowLayout  gives  components  their  preferred  size  in 
both  dimensions. 

■ BoxLayout  lets  you  align  components  stacked 
vertically,  even  if  they  could  fit  side-by-side.  Like 
FlowLayout,  BoxLayout  uses  the  preferred  size  of 
the  component  in  both  dimensions. 

■ BorderLayout  is  the  default  layout  manager  for  a 
frame;  FlowLayout  is  foe  default  for  a panel. 

■ If  you  want  a panel  to  use  something  other  than  flow, 
you  have  to  call  setLayout()  on  foe  panel. 
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Playing  with  Swing  components 

You’ve  learned  the  basics  oflayout  managers,  so  now  let’s  try  out  a 
few  of  the  most  common  components:  a text  field,  scrolling  text  area, 
checkbox,  and  list  We  won’t  show  you  the  whole  dam  API  for  each  of 
these,  just  a few  highlights  to  get  you  started. 


JTextFleld 


Jn*tField 


Constructors 

JTextFiald  field 


new  JTextFiald (20) ; 
JTextFiold  field  = now  JTextFiald ("Your  name")  ; 


How  to  use  It 

£ Set  text  out  of  it 

System. out. println  (field.  getTaxt()  ) ; 


^ Put  text  in  it 


field . setText ( "whatever" ) ; 


Set  an  ActionEvent  when  the  user 
presses  return  or  enter 


*a«y  »a»l  ie  *****  y»- 

field. addActionListener (myActionListener) ; 


£ SeJect/Highlight  the  text  in  the  field 

field. aeleetAll  ()  ; 


0 Put  the  cursor  back  in  the  field  (so  the  user 
can  just  start  typing) 

field . requestFocus  ( ) ; 
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JTextArea 


Unlike  JTextField,  JTextArea  can  have  more  than  one  line  of  text.  It 

takes  a little  configuration  to  make  one,  because  it  doesn't  come  out  of 

the  box  with  scroll  bars  or  line  wrapping.  To  make  a JTextArea  scroll,  you 

have  to  stick  it  in  a ScrollPane,  A ScrollPane  is  an  object  that  really  loves 

to  scroll*  and  will  take  care  of  the  text  area's  scrolling  needs.  % . * l> 

Constructor  / 

JTextArea  text  * new  JTextArea (10, 20) ; 


t 


How  to  use  It 

0 Make  it  have  a vertical  scrollbar  only 


^ ** 

JSarollPanA  scroller  ■ n®w  JScrollPane  (tAxt)  ; Tell  £he  scroll  pdri^  ^ 

text . ae tLineWrep  ( true ) ; « ^ ^ ^ W wraffir*  £ a 2^  •OrolL- 

acroller . eetVerticelScrollBarPollcy (ScrollPaneConatanta . VERTICAL_SCROLLBAR_ALMAYS) ; 
scroller . aetHorirontalScrollBarPollcy ( Scroll Pan  eCona tints . HORI Z ONTAL_ 8 CROLLBAR_NEVER ) 

panel . add (acroller)  , 

Replace  the  text  that's  in  it  y ihe  ?*»'>!  P ' ^ 

text.  aetText  ("Hot  all  who  are  loat  aire  wandering"); 


0 Append  to  the  text  that's  in  it 

tAxt. append ("button  cliaJcAd") ; 

0 Select/Highlight  the  text  in  the  field 

tAxt.  0«lsctAll  0 ; 

0 Put  the  cursor  back  in  the  field  (so  the  user 
can  just  start  typing) 

text.  rAquAfltFocus  ()  ; 
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JTextArea  example 


in^ort  javax. swing.  *; 
inport  java.awt.*; 
import  java. awt. event.*; 


public  class  TextAreal  implements  ActionLlstaner  { 
JTextArea  text; 

public  static  void  main  (String []  args)  { 
TaxtAreal  gui  = new  TextAreal(); 
gui.go()  ; 

} 


public  void  go ()  { 

JFrame  frame  ■ new  JFrame  ( ) ; 

JPanel  panel  = new  JPanel  ()  ; 

JButton  button  = new  JButton  ("  Just  Click  It"); 
button. addActionListener (this) ; 
text  = new  JTextArea (10 ,20) ; 
text.  setLineWrap  (true)  / 

JScrollPane  scroller  = new  JScrollPane (text) ; 
scroller . setVerticalScrollBarPoiicy  (ScrollPaneConstants  . VERT  I CAL_SCROLLHAR_ALWAY  S ) ; 
scroller . setHorizontalScrollBarPolicy  (ScrollPaneCons  tants  - HORIZONTAL_SCROIiIAAR_KEVER)  ; 

panel . add (scroller) ; 

frame , getContentPane  ( ) . add  ( Border  Lay  out.  CENTER,  panel)  ; 
frame . getContentPana ( ) . add (Border Layout , SOUTH , button) ; 


see 

'button  clicked 
button  clicked 
button  clicked 


[ 


If— 


frame. setSize (350, 300) ; 
frame . setvisible  (true)  ; 
i 
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JCheckBox 


Constructor 

JCheckBox  check  = new  JCheckBox (" Goes  to  11"); 


How  to  use  It 

$ Listen  for  an  item  event  (when  it's  selected  or  deselected) 

check . addl temLis  tener ( this ) ; 


% Handle  the  event  (and  find  out  whether  or  not  it's  selected) 

public  void  itemStateChanged(ItemEvent  ev)  { 

String  onOrOff  = "off"; 

if  (check. isSelected() ) onOrOff  = "on"; 

System. out. prin tin ("Check  box  is  " + onOrOff); 


$ Select  or  deselect  it  in  code 

check. setSelec ted (true) ; 
check. setSelected (false) ; 


dwnl't^uestfens 

Aren't  the  layout  manag- 
ers just  more  trouble  than  they're 
worth?  If  I have  to  go  to  all  this 
trouble,  I might  as  well  just  hard- 
code  the  size  and  coordinates  for 
where  everything  should  go. 

Getting  the  exact  layout 
you  want  from  a layout  man- 
ager can  be  a challenge.  But  think 
about  what  the  layout  manager 
is  really  doing  for  you.  Even  the 
seemingly  simple  task  of  figuring 
out  where  things  should  go  on 
the  screen  can  be  complex.  For 
example,  the  layout  manager  takes 
care  of  keeping  your  components 
from  overlapping  one  another. 

In  other  words,  it  knows  how  to 
manage  the  spacing  between 
components  (and  between  the 
edge  of  the  frame).  Sure  you  can 
do  that  yourself,  but  what  happens 
if  you  want  components  to  be 
very  tightly  packed?  You  might  get 
them  placed  just  right  by  hand, 
but  that's  only  good  for  your  JVM! 

Why?  Because  the  components 
can  be  slightly  different  from 
platform  to  platform,  especially  if 
they  use  the  underlying  platform's 
native  'look  and  fee!'.  Subtle  things 
like  the  bevel  of  the  buttons  can 
be  different  in  such  a way  that 
components  that  line  up  neatly 
on  one  platform  suddenly  squish 
together  on  another. 

And  we're  still  not  at  the  really  Big 
Thing  that  layout  managers  do. 
Think  about  what  happens  when 
the  user  resizes  the  window!  Or 
your  GUI  is  dynamic,  where  com- 
ponents come  and  go.  If  you  had 
to  keep  track  of  re-laying  out  all 
the  components  every  time  there's 
a change  in  the  size  or  contents  of 
a background  component...yikes! 
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JList 


Constructor 


ucU-  a 

£'■  The,  ^ *j“* 


String  []  listEn tries  = ("alpha",  "beta",  '"gamma",  "delta", 

"epsilon" , "zeta",  "eta",  "theta  "1; 

list  = new  JList (listEntriea) ; 


How  to  use  It 

A Make  ft  have  a vertical  scrollbar 


JScrollPane  scroller  * new  JScrollPane(list); 

scroller . setVerti cal ScrollBar Pol icy (ScrollPaneCons tants . VERTICAL_SCROLLBAR_ALWAYS ) ; 
scroller. setHorixontalScrollBar Policy (ScrollPaneConatants . HORI ZONTAL_SCROLLHAR__NEVER) 

panel , add (scroller) ; 


Set  the  number  of  lines  to  show  before  scrolling 

list. setVisibleRowCoimt (4)  ; 


O Restrict  the  user  to  selecting  only  ONE  thing  at  a time 

list.  setSelectionMode (ListSeleotionModel . S INGLE_SELECT ION ) ; 


Register  for  list  selection  events 

list. addListSelectionListener (this) ; u 

y„’«^^^TWICE,tr’ 

Handle  events  (find  out  which  thing  in  the  list  was  selected)  , t1*^  m 

public  void  valueChanged  (ListSelectionEvent  lse)  ( . 

if  ( ! lse ■ getValualsAdjustingO  ) { 

String  selection  = (String)  list . getSelectedValue 0 
System. out. println (seleotion)  ; 


) 


} 


0bje4t  A lidi  i'i 
liioited  io  o*ly  Sfrinj 
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Code  Kitchen 


* * 

Code  Kitcken 


Cyber  Bear  Box 


Bass  Drum  □ Q D 0 □ O M O O 0 □ MO  □ DO 
ClosedHI-Hat  QOM  QQQDO  O G QUO  MOO 

Open  Hl-Hat  0 Q □ 000 Q □ O 0 □ □ □ □ M □ 


Tempo  Up 


Acoustic 


Tempo  Down 


Crash  Cymbal  Q Q M M O O OO  MO  O O Q O O O 

□ DO  OG OOO 00000000 
MB ood □ □□□□□□□□□□ 
boo  DO  000000000  0 0 
o a a oo o a Mooao odd  o 
bob  oooaboo aab bo a 
d do  Ddaao ooooooob 
a om  o a ooo  o M mmo  o m a 
a o ooo oo  o oo M b a ooo 

Low- mid  Tom  Q QQ 0000 OOO  00  OOMO 
High  Agoflo  .OM  0 D 0,M  OO  O O O MO  0.0  a 
Open  HI  CongaQ  Q Q DO  OOO  O 00  00 OOO 


Maracas 


Whistle 


Low  Conga 


Cowbell 


Tkis  parts  optional  We’re  malting  tke  full  Beat  Box,  GUI 
ant  alL  In  tke  Saving  Okjects  ckapter,  well  learn  kow  to 
save  ant  restore  drum  patterns.  Finally,  in  tke  networking 
ckapter  (Make  a Connection),  we’ll  turn  tke  BeatBox  into  a 
working  ckat  client. 
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Making  the  PeatPox 

This  is  the  full  code  listing  for  this  version  of  the  BeatBox,  with  buttons  for  starting, 
stopping,  and  changing  the  tempo.  The  code  listing  is  complete,  and  fully- 
annotated,  but  here’s  the  overview: 


Build  a GUI  that  has  256  checkboxes  (JCheckBox)  that  start  out 
unchecked,  16  labels  (JLabel)  for  the  instrument  names,  and  four 
buttons. 

Register  an  ActionListener  for  each  of  the  four  buttons.  We  don't 
need  listeners  for  the  individual  checkboxes,  because  we  aren't 
trying  to  change  the  pattern  sound  dynamically  (i.e.  as  soon  as  the 
user  checks  a box).  Instead,  we  wait  until  the  user  hits  the  ’start’ 
button,  and  then  walk  through  all  256  checkboxes  to  get  their  state 
and  make  a MIDI  track. 


Set-up  the  MIDI  system  (you've  done  this  before)  including  getting 
a Sequencer,  making  a Sequence,  and  creating  a track.  We  are  using 
a sequencer  method  that's  new  to  Java  5.0,  setLoopCount( ).  This 
method  allows  you  to  specify  how  many  times  you  want  a sequence 
to  loop.  We're  also  using  the  sequence’s  tempo  factor  to  adjust  the 
tempo  up  or  down,  and  maintain  the  new  tempo  from  one  iteration  of 
the  loop  to  the  next. 


When  the  user  hits  ‘start’,  the  real  action  begins.  The  event-handling 
method  for  the  ’start'  button  calls  the  buildTrackAndStart()  method. 
In  that  method,  we  walk  through  all  256  checkboxes  (one  row  at 
a time,  a single  instrument  across  all  16  beats)  to  get  their  state, 
then  use  the  information  to  build  a MIDI  track  (using  the  handy 
makeEvent()  method  we  used  in  the  previous  chapter).  Once  the  track 
is  built,  we  start  the  sequencer,  which  keeps  playing  (because  we’re 
looping  it)  until  the  user  hits  ’stop’. 
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BeatBox  code 


inport  java.awt.*; 
insert  javax. swing. * ; 
import  javax.  sound. midi  . * ; 
import  java. util . * ; 
import  java. awt. event .* ; 


public  class  BeatBox  { 


JPanel  mainPanel; 

ArrayList<JCheckBox>  checkboxList; 
Sequencer  sequencer; 

Sequence  sequence; 

Track  track; 

JFrame  the  Frame; 


VJi 


jtov£  the  rn  a*  frnr^Lai 


nw  are  toe  *»■*>«  «f  iwtrumo.tx,  ai  3 

a»ray,  -for  buildmj  the  <^U|  labels  (<>►,  eJdh  vow) 

String []  InatrumentNames  = {"Bass  Drum",  "Closed  Hi-Hat", 

"Open  Hi-Hat" , "Acoustic  Snare",  "Crash  Cymbal",  "Hand  Clap", 

"High  Tom",  "Hi  Bongo",  "Maxacas",  "Whistle",  "Low  Conga", 

"Cowbell",  "Vibraslap",  "Low-mid  Tom",  "High  Agogo", 

"Open  Hi  Conga" ); 

±nt[)  instruments  = <35 , 42 , 46,38 , 49, 39 , 50 , 60 , 70 , 72 , 64 , 56 , 5S , 47 , 67 , S3) ; 


public  static  void  main  (String []  args)  { 
new  BeatBox2() ,buildGOI() ; 


TVie  represent  the  aetml  drum  'keys'. 

he  drum  dhahnel  is  like  a piano,  except 
eadh  key  on  the  piano  is  a different  drum. 
) So  the  number  **5  is  the  key  for  the  Bass 

drum,  4-2.  is  Closed  Ri-Hat,  ltd. 

public  void  buildOTI (>  < 

the  Frame  = new  JFrame  ("Cyber  BeatBox"); 

the Frame . setDef aultCloseOperation ( JFrame . EXIT_ON_CLOSE) ; 

Border Lay out  layout  = new  BorderLayout () ; 

JPanel  background  = new  JPanel (layout) ; 

background. setBorder (Border Factory . creataEmptyBorder (10,10,10,10)) ; 


checkboxList  = new  ArrayList<JCheckBox>  ()  ; 

Box  buttonBox  = new  Box (BoxLayout . Y_AXIS) ; 

JButton  start  = new  JButton  ("Start")  ; 

start . addAc tic tiListener  (new  MyStartListener  ()  ) ; 

buttonBox. add (start) ; 

JButton  stop  = new  JButton ("Stop") ; 

stop . addActionListener (new  MyStopListaner () ) ; 

buttonBox. add (stop) ; 

JButton  up Tempo  = new  JButton ("Tempo  Dp"); 
upTempo  .addActionListener  (new  MyUpTempoListaner () ) 
buttonBox . add (upTempo) ; 

JButton  downTempo  = new  JButton ("Tempo  Down"); 


where  the  pJ"el  and 


M*g 

d ode.  yo-'-e  *e«  ^ 
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downTempo . addActionlds tenor  (new  MyDownTempoListener  ( ) ) ; 
buttonBox . add (down  Tempo) ; 

Box  namaBox  = new  Box(BoxLayout.Y_AXIS)  ; 
for  (int  1 = 0;  i < 16;  1-H-)  { 

namaBox  .add  (new  Label  (instrumantNamas  [i] ))  ; 

} 

background. add (BorderLayout. EAST,  buttonBox)  ; 
background . add (Border Layout .WEST , namaBox) ; 

the Frame . getContentPane ( ) . add (background) ; 

GridLayout  grid  = new  GridLayout(16y 16) ; 
grid. aatVgap (1) ; 
grid.setHgap(2) ; 
mainPanel  = new  JPanel (grid) ; 

background. add (BorderLayout .CENTER,  mainPanel)  ; 


*afs 

Add 


theFrame. setBounds (50,50,300,300) ; 

theFrama . pack ( ) ; 

thaFrama . aatVisible  (true)  ; 

) //  close  method 


IL  th***d)  and 


for  (int  i = 0;  i < 256;  i++)  ( 

JCheckBox  c = new  JChsckBox ( ) ; 
c . setSelacted (false) ; 
checkboxList. add(c) ; 
mainPanel . add(c) ; 

) //  and  loop 


setUpMidi  ( ) ; 


Still  ^ ^ 

remarlcabic- 


public  void  setD^MidlO  ( 
try  { 

sequencer  = MidiSystem.  getSequencer  () 
sequencer < open ( ) ; 

sequence  = naw  Sequence (Sequence ,PPQy 
track  = sequence . createTrack () ; 
sequencer . aetTempoInBPM (120) ; 


ihe  TV«k. 


) cat ah (Exception  e)  (e .prints taakTrace () ; } 
) //  close  method 
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TWls  is  Vt  ail  bafH  ^ "f 

twr*  dhedkW  slaie  «^>  MlPl  «vents' 

and  add  bfce»  bo  b**  Tratk- 

public  void  bu i ldTrackAndStart ( ) { 
int[]  trackList  = null;  ^ 


sequence . deleteTrack ( track) ; 
track  = sequence . createTrack ( ) ; 


for  (int  i « 0;  i < 16;  i++)  { 
trackList  = new  int[16]; 


. , ie„erit  m*l  '*  , 

We1"  ll  twt  tleTwl 

“ NCT 

R0W£  e'  BS“'  ^ *W 


lot  ley  - inseranttnts  [1] ; W e*k 


for  (int  j = 0;  j < 16;  j++  ) { 


JCheckBox  jc  = (JCheckBox)  checkboxList.get ( j + (16*i)); 
if  ( jc.isSelected() ) { ^ 

} elseCl(LlSt[^  ^ 7>  Is  the  ehedkbo*  at  -this  beat  seletted?  It  yes,  Put 

trackList  m = 0 • \ the  key  value  in  this  slot  in  the  array  (the  slot  that 

} ’ J represents  this  beat)-  Otherwise,  the  instrument  is 

} //  close  inner  loop  ' NOT  supposed  to  play  at  this  beat,  so  set  it  to  zero- 


makeTracks (trackList)  ; ^ jror  this  instrument,  and  tor  all  I h beats, 

track. add(makeEvent(176, 1,127, 0,16) ) ; events  and  add  them  to  the  tratk- 

> //  close  outer 


track . add (makeEvent (192,9,1,0,15)) ; 
try  { 


We  always  want  to  make  sure  that  there  IS  an  event  at 
beat  H>  lit  joes  0 to  15).  Otherwise,  the  Deattfo*  m.jht 
not  jo  the  lull  It  beats  before  it  starts  over- 


} 

// 


sequencer. setSequence (sequence) ; 
sequencer . setLoopCount  (sequencer . LOOPjCONTINUOUSLY) 
sequencer. s tart () ; 

sequencer . setTerapoInBFM (120)  ; "\ 

catch (Exception  e ) { e . prints tackTr ace ( ) ; } j 

close  buildTrackAndStart  method 


LeV$  you  specify  i Kc  *ur*ber 

of  loof  iiera,h<m$,  or  m this 
6ase,  tontmuous  loo^m^- 


NOW  PLA/  tpe  tm#! 


public  class  JQjr3$tacbI>is tener  implements  AetionListener  { 
public  void  actionPerformed (ActionEvent  a)  { 
buildTrackAndStartO  ; 

} 

} //  close  inner  class 


First  ot  the  inner  elasses, 
listeners  tor  the  buttons, 
wthinj  special  here. 
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public  class  implements  ActionListener  { 

public  void  actionPerf  ormed  (ActionEvent  a)  { 
sequencer . stop ( ) ; 

} 

} //  close  inner  class 

public  class  1 fyOpTampoListenar  implements  ActionListener  { 
public  void  actionPerf ormed  (ActionEvent  a)  { 

float  tempoFactor  = sequencer .getTempoFactor  ()  ; 
sequencer . setTempoFactor  ( (float)  (tempoFactor  * 1 . 03) ) ; 

) 

} //  close  inner  class 

public  class  j§ implements  ActionListener  ( 
public  void  actionPerf  ormed  (ActionEvent  a)  { 
float  tempoFactor  » sequencer. getTempoFactor () ; 
sequencer . setTempoFactor  ( (float)  (tempoFactor  * . 97) ) ; 

} 

} //  close  inner  class 


The  oiher  ihhcvr  dass 
Iwtenap*  -for  ihe  buiio* 


r 

j The  T cmfo  Fatior  stales 

J ihe  sequencer's  ie*po  by 

' ihe  -factor  provided-  The 

de-fauii  \$  l.0}  so  were 
adjusting  +/ - 3%  per 
click- 


public  void  (int  [ ] list)  { 

for  (int  i = 0;  i < 16;  i++)  { 
int  key  * list[i] ; 


>11  It  bob-  So  * ■ ** » f J,  ril*. 

dvw*.,  aind  e^  inde*-  **»  i -aero.  I-C  it’s  a 
tbe  key  «*  M at  tKat  beat 

tbe  >^t  £ Se  -brack- 

Otbevwise,  «>ake  a*  event  and  add  * 


if  (key  !=  0)  { 

track . add (makeEvent (144,9, key , 100 
track . add  (makeEvent  (128,9,  key , 100 

) 


' Hits  ^ Make  tbe  KOTt  OK  and 

, i+i)  > , ) Qfp  cvc*fcs>  a*d 
add  ihe*  i<>  tk*  Tratk. 


} 


public  MidiEvent  makeEvent  (int  comd,  int  chan,  int  one,  int  two,  int  tick)  { 
Midi Event  event  « null; 
try  { 

ShortMessage  a = new  ShortMessage () ; 
a.setMessage(comd,  chan,  one,  two);  y. 

event  * new  MidiEvent  (a,  tick)  ; *s*s  utility  ^ 


} catch (Exception  e)  { e. prints tackTrace () 
return  event; 


dhapicV'S  CoAm^'l  LCtV*  *'ro»' 
a } ^ 5Lodc^W^hm3 


Iasi 

*ew. 


} //  close  class 
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exercise:  Which  Layout? 


Which  code  goes  with 
which  layout? 

Five  of  the  sfx  screens  below  were  made  from  one 
of  the  code  fragments  on  the  opposite  page,  Match 
each  of  the  five  code  fragments  with  the  layout  that 
fragment  would  produce. 
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Code  Fragments 


OJFrame  frame  = new  JFrame  ( ) ; 

JPanel  panel  = new  JPanel ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton  button  = new  JButton ("tesuji") ; 

JButton  buttonTwo  = new  JButton  ("watari")  ; 

frame . getCon tent Pane ( ) . add (BorderLayout . NORTH , panel ) ; 

panel . add (buttonTwo) ; 

frame . getCon tent Pane ( ) . add (BorderLayout . CENTER , button ) ; 


©JFrame  frame  = new  JFrame ( ) ; 

JPanel  panel  = new  JPanel ( ) ; 

panel . se tBackground (Color . darkGray) ; 

JButton  button  = new  JButton ("tesuji") ; 

JButton  buttonTwo  « new  JButton  ("watari")  ; 
panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER / button) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel) ; 


JFrame  frame  = new  JFrame  ( ) ; 

JPanel  panel  = new  JPanel  ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton  button  = new  JButton ( "tesuj i" ) ; 

JButton  buttonTwo  = new  JButton ("watari") ; 
panel . add (buttonTwo) ; 

frame . getContentPane ( ) .add (BorderLayout. CENTER, but ton) ; 


OJFrame  frame  = new  JFrame  ( ) ; 

JPanel  panel  = new  JPanel ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton  button  = new  JButton ("tesuji") ; 

JButton  buttonTwo  = new  JButton ("watari") ; 
panel . add (button) ; 

frame . getContentPane  ( ) . add  (BorderLayout . NORTH , buttonTwo ) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel ) ; 


JFrame  frame  = new  JFrame  ( ) ; 

JPanel  panel  = new  JPanel ( ) ; 

panel . setBackground (Color . darkGray) ; 

JButton  button  = new  JButton (" tesuj i ") ; 

JButton  buttonTwo  = new  JButton ( "watari" ) ; 

frame . getContentPane  ( ) . add  (BorderLayout . SOUTH , panel ) ; 

panel . add (buttonTwo) ; 

frame . getContentPane  ( ) . add  (BorderLayout . NORTH , button)  ; 
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puzzle:  crossword 


You  can  do  It 


Across 

I.  Artists  sandbox 

4.  Bordets  catchall 

5,  Java  look 

9.  Generic  waiter 

II.  A happening 

12.  Apply  a widget 

15.  JPanel's  default 

16.  Polymorphic  test 


17.  Shake  It  baby 
21.  Lots  to  say 
23.  Choose  many 

25.  Button's  pal 

26.  Home  of 
action  Performed 


Down 

Z Swing's  dad 
3.  Frame's  purview 

5.  Help's  home 

6.  More  fun  than  text 

7.  Component  slang 

8.  Romulin  command 

9.  Arrange 

10.  Border's  top 


13.  Manager's  rules 

14.  Source's  behavior 

15.  Border  by  default 

18.  User's  behavior 

19.  Inner's  squeeze 

20.  Backstage  widget 
22.  Mac  look 

24.  Borders  right 
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Exercise  Solutions 


OJFrame  frame  = new  JFrame  ()  ; 

JPanel  panel  = new  JPanel  () ; 

panel . aetBackground  (Color . dark.Gr ay)  ; 

JButton  button  = new  JButton ("teauji") ; 

JButton  buttonTwo  = new  JButton  ("watari")  ; 
panel . add (buttonTwo) ; 

frame.getContentPaneO  . add (BorderLayout. CENTER, button)  ; 


OJFrame  frame  - new  JFrame  ()  ; 

JPanel  panel  = new  JPanel ( ) ; 

panel . aetBackground (Color . darkGray)  ; 

JButton  button  = new  JButton ("teauji") ; 

JButton  buttonTwo  - new  JButton ("watari") ; 
f raffle ■ getContantPane ( ) . add (Border Layout , NORTH , panel) ; 
panel . add (buttonTwo) ; 

frame .getContantPane () . add (Border Lay out . CENTER, button) ; 


©JPrame  frame  = new  JFrame  ()  ; 

JPanel  panel  = new  JPanel (); 

panel . ae  tBack ground (Color . darkGray) ; 

JButton  button  = new  JButton ("tesuji" > ; 

JButton  buttonTwo  = new  JButton ("watari") ; 

frame. getContantPane  ()  . add (BorderLayout . SOUTH , panel)  ; 

panel . add (buttonTwo) ; 

frame , getContantPane { ) , add (BorderLayout . NORTH , button) ; 


OJFrame  frame  = new  JFrame  ()  ; 

JPanel  panel  = new  JPanel (); 

panel . aetBackground (Color . darkGray) ; 

JButton  button  = new  JButton ("tesuji") ; 

JButton  buttonTwo  = new  JButton ("watari") ; 
panel . add (button) ; 

frame.  getContantPane  ()  .add  (BorderLayout.  NORTH, buttonTwo)  ; 
f rame . getContantPane 0 .add (BorderLayout. BAST,  panel) ; 


OJFrame  frame  = new  JFrame  ()  ; 

JPanel  panel  » new  JPanel  <); 

panel . aetBackground  (Color  . darkGray)  ; 

JButton  button  = new  JButton ("teauji") ; 

JButton  buttonTwo  o new  JButton (" wa tar i") ; 
panel . add (buttonTwo) ; 

frame. getContantPane () .add (BorderLayout. CENTER, button) ; 
frame . getContantPane  ()  . add (BorderLayout . EAST,  panel); 
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'aSS7.0 


Objects  can  be  flattened  and  inflated.  Objects  have  state  and  behavior. 
Behavior  lives  In  the  class,  but  state  lives  within  each  individual  object  So  what  happens  when 
it's  time  to  save  the  state  of  an  object?  If  you're  writing  a game,  you're  gonna  need  a Save/ 
Restore  Game  feature.  If  you're  writing  an  app  that  creates  charts,  you're  gonna  need  a Save/ 
Open  File  feature.  If  your  program  needs  to  save  state, you  can  do  It  the  hard  way,  interrogating 
each  object,  then  painstakingly  writing  the  value  of  each  instance  variable  to  a file,  In  a 
format  you  create.  Or,  you  can  do  It  the  easy  00  way — you  simply  freeze-dry/flatten/persist/ 
dehydrate  the  object  itself,  and  reconstltute/lnflate/restore/rehydrate  it  to  get  it  back.  8ut  you'll 
still  have  to  do  it  the  hard  way  sometimes,  especially  when  the  file  your  app  saves  has  to  be  read 
by  some  other  non-Java  application,  so  we'll  look  at  both  in  this  chapter. 
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Capture  the  Peat 


\ m eo^u0 

V 

\ Co***'' 

\ s/vbffr*^ 
\ 

\HWh;W 
\ Ot*n  wl 


You've  made  the  perfect  pattern.  You  want  to  save  the  pattern. 
You  could  grab  a piece  of  paper  and  start  scribbling  it  down,  but 
instead  you  hit  the  Smte  button  (or  choose  Save  from  the  File 
menu).  Then  you  give  it  a name,  pick  a directory, 
and  exhale  knowing  that  your  masterpiece  won’t  go 
out  the  window  with  the  blue  screen  of  death. 

You  have  lots  of  options  for  how  to  save  the  state  of 
your  Java  program,  and  what  you  choose  will  probably 
depend  on  how  you  plan  to  use  the  saved  state.  Here 
are  the  options  we’ll  be  looking  at  in  this  chapter. 

If  your  data  will  be  used  by  only  the  Java 
program  that  generated  It: 

# Use  serialization 

Write  o file  that  holds  flattened  (serialized) 
objects.  Then  have  your  program  read  the 
serialized  objects  from  the  file  and  inflate  them 
back  into  living,  breathing,  heap-inhabiting  objects. 


If  your  data  will  be  used  by  other  programs: 

<D  Write  a plain  text  file 

Write  a file,  with  delimiters  that  other  programs  can  parse. 
For  example,  a tab-delimited  file  that  a spreadsheet  or 
database  application  can  use. 


These  aren't  the  only  options,  of  course.  You  can  save  data  in  any 
format  you  choose.  Instead  of  writing  characters,  for  example, 
you  can  write  your  data  as  bytes.  Or  you  can  write  out  any  kind 
of  Java  primitive  os  a Java  primitive — there  are  methods  to  write 
ints,  longs,  booleans,  etc.  Bui  regard Jess  of  the  method  you  use, 
the  fundamental  I/O  techniques  are  pretty  much  the  same: 
write  some  data  to  something,  and  usually  that  something  is  either 
a file  on  disk  or  a stream  coming  from  a network  connection, 
Reading  the  data  is  the  same  process  in  reverse:  read  some  data 
from  either  a file  on  disk  or  a network  connection.  And  of  course 
everything  we  talk  about  in  this  part  is  for  rimes  when  you  aren't 
using  an  actual  database. 
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Saving  State 

Imagine  you  have  a program,  say,  a fantasy 
adventure  game,  that  takes  more  than  one 
session  to  complete.  As  the  game  progresses, 
characters  in  the  game  become  stronger,  weaker, 
smarter,  etc,,  and  gather  and  use  {and  lose) 
weapons.  You  don't  want  to  start  from  scratch 
each  time  you  launch  the  game — it  took  you 
forever  to  get  your  characters  in  top  shape  for 
a spectacular  battle.  So,  you  need  a way  to  save 
the  state  of  the  characters,  and  a way  to  restore 
the  state  when  you  resume  the  game.  And  since 
you’re  also  the  game  programmer,  you  want  the 
whole  save  and  restore  thing  to  be  as  easy  (and 
foolproof)  as  possible. 

# Option  one 

Write  the  three  serialized 
character  objects  to  a file 

Create  a file  and  write  three  serialized 
character  objects.  The  file  won’t  make 
sense  if  you  try  to  read  it  as  text: 

'jbattamdGharaotar 

String;  [wasponst  [Xdava/lang/ 
8trtng;xp2tlfur  py  avadang^Strlng^^vA 
4{Gxptbowtawordtdustsq~»WtoUttQ~tb 
are  handstbig  axgq~xtMA|fldftnuq~tape 
listin' visibility 

# Option  two 

Write  a plain  text  file 

Create  a file  and  write  three  lines  of  text, 
one  per  character,  separating  the  pieces 
of  state  with  commas: 

SO^SOfjborw,  eerordjdust 
ftOOjTroliibare  hands, big  ax 
ISO, Maglolan,spalla, In  visibility 


ma£ine  y 
;ave  tltrei 
Procters 


GameCharacter 


(nt  power 
String  type 
WeaponQ  weapons 


getWeaponO 
useWeapon() 
increasePower() 
II  more 


fewer*  w 
type-  Elf 
weapons-  bow, 
sword,  dus^f 


fpower:  200 " 
•type:  Troll 
weapons:  bare 
>hands,  big  a*. 


power:  1 20  ^ 

-type--  MagitiaJ 
weapons:  spell*, 
.invisibility  Jk 


*•1 


ore 


obitfCfc  fL  r *>  to 

' -to h *fciifc 

*f  w? 
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Writing  a serialized  object  to  a file 

Here  are  the  steps  for  serializing  (saving)  an  object  Don't  bother 
memorizing  all  this;  well  go  into  more  detail  later  in  this  chapter. 


j 


Make  a FHeOutputStream 

FileOutputStxeam  file  Stream  = new  FHeOutputStream  ("MyGame . ser")  ; 

^ake  * 

“*»«  Kow  h,  / ofcieei  C;  A , 

i,  (J  ctJkjffateb 

Make  an  ObjectOutputStream 

ObjeotOutputStream  os  - new  ObjectOutputStream  (fileStream)  ; 

«rf^SSS,  £&  ^ 


Write  the  object 

os .writeObject (characterOne) ; 
os .writeObject (characterTwo) ; 
os . writeObject (characterThree) 


Close  the  ObjectOutputStream 


os . close  () 


0*CS 

tKe 
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Pata  moves  in  streams  from  one  place  to  another 


Connection 
streams  represent 
a connection 
to  a source  or 
destination  (file, 
socket  etc.)  while 
chain  streams 
can't  connect  on 
their  own  and  must 
be  chained  to  a 
connection  stream. 


The  Java  I/O  API  has  connection  streams,  that  represent  connections  to  destinations  and 
sources  such  as  files  or  network  sockets,  and  chain  streams  that  work  only  if  chained  to 
other  streams. 


Often,  it  takes  at  least  two  streams  hooked  together  to  do  something  useful — one  to 
represent  the  connection  and  another  to  call  methods  on.  Why  two?  Because  connection 
streams  are  usually  too  low-level.  FileOutputStream  (a  connection  stream),  for  example, 
has  methods  for  writing  bytes.  But  we  don't  want  to  write  bytes]  We  want  to  write  objects,  so 
we  need  a higher-level  chain  stream. 


OK,  then  why  not  have  just  a single  stream  that  does  exactly  what  you  want?  One  that  lets 
you  write  objects  but  underneath  converts  them  to  bytes?  Think  good  OO.  Each  class 
does  one  tiling  well.  FileOutputStreams  write  bytes  to  a file.  ObjectOutputStreams  turn 
objects  into  data  that  can  be  written  to  a stream.  So  we  make  a FileOutputStream  that  lets 
us  write  to  a file,  and  we  hook  an  ObjectOutputStream  (a  chain  stream)  on  the  end  of  it. 
When  we  call  writeObject()  on  the  ObjectOutputStream,  the  object  gets  pumped  into  the 
stream  and  then  moves  to  the  FileOutputStream  where  it  ultimately  gets  written  as  bytes 
to  a file. 


The  ability  to  mix  and  match  different  combinations  of  connection  and  chain  streams 
gives  you  tremendous  flexibility!  If  you  were  forced  to  use  only  a single  stream  class,  you'd 
be  at  the  mercy  of  the  API  designers,  hoping  they'd  thought  of  everything  you  might  ever 
want  to  do.  But  with  chaining,  you  can  patch  together  your  own  custom  chains. 


1 

» is  written  to 


object  is  flattened  (serialized) 

-+ 


object  is  written  as  bytes  to 


Object 


is  chained  to 


011010010110111001 


i 


ObjectOutputStream 
(a  chain  stream) 


FileOutputStream 
(a  connection  stream) 
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What  really  happens  to  an  object 
when  it's  serialized? 


0 Object  on  the  heap 


0 Object  serialized 


Objects  on  the  heap  have  state— the 
value  of  the  object's  instance 
variables.  These  values  make  one 
instance  of  a class  different  from 
another  instance,  of  the  same  class. 


Serialized  objects  save  the  values 
of  the  instance  variables,  so  that 
an  identical  instance  (object)  can  be 
brought  back  to  life  on  the  heap. 


-U  **  f*,'4 


ooiooioi 


01000110 


Ue  variable  val*« 
wdtt  and  height  ^ 
ve d to  the  -file  Hoo-scr" 


- - <'oo.ser  - 
wth  J ^tle  mo*-e  J0 


)l/AA  , "'ore  m- 

L ,h/eds  to 
* tjf£t  viha-t  its 
type  is). 


FileOutputStroam  fs  = now  FileOutputStreamC'foo.aer") 


ObjectOutputStream  oe 
os . wri taQb jeet (myFoo) 


now  ObjectOutputStroam(fs) 


Foo  myFoo  = now  Foo ( ) ; 
myFoo . setWidth  (37)  ; 
myFoo. sotHoight (70) ; 


^ tell 

^jcitOu-fcpotSt^^  to  write  the  « 
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Put  what  exactly  jS  an  object's  state? 
What  needs  to  be  saved? 

Now  it  starts  to  get  interesting.  Easy  enough  to  save  the  primitive 
values  37  and  70.  But  what  if  an  object  has  an  instance  variable 
that's  an  object  reference*  What  about  an  object  that  has  five 
instance  variables  that  are  object  references?  What  if  those  object 
instance  variables  themselves  have  instance  variables? 

Think  about  it.  What  part  of  an  object  is  potentially  unique? 
Imagine  what  needs  to  be  restored  in  order  to  get  an  object  that's 
identical  to  the  one  that  was  saved.  It  will  have  a different  memory 
location,  of  course,  but  we  don’t  care  about  that.  All  we  care  about 
is  that  out  there  on  the  heap,  we’ll  get  an  object  that  has  the  same 
state  the  object  had  when  it  was  saved. 


Brain  Barbell 


What  has  to  happen  for  the  Car 
object  to  be  saved  in  such  a way 
that  It  can  be  restored  back  to  its 
original  state? 

Think  of  what — and  how — you 
might  need  to  save  the  Car. 

And  what  happens  if  an  Engine 
object  has  a reference  to  a 
Carburator?  And  what's  inside  the 
Tire  Q array  object? 


The  Car  object  has  two 
instance  variables  that 
reference  two  other 
objects. 


~or  ob’^ 


Oar raV  ** 


What  does  It  take  to 
save  a Car  object? 


you  are  here  ► 435 


serialized  objects 


d0g  0b  \^ 


When  you  save  the  Kennel,  al[  of  this  is  saved! 


When  an  object  is  serialized,  all  the  objects 
it  refers  to  from  Instance  variables  are  also 
serialized.  And  all  the  objects  those  objects 
refer  to  are  serialized.  And  all  the  objects  those 
objects  refer  to  are  serialized...  and  the  best 
part  Is,  it  happens  automatically! 

This  Kennel  object  has  a reference  to  a Dog  []  array  object.  The 
Dog  []  holds  references  to  two  Dog  objects.  Each  Dog  object  holds 
a reference  to  a String  and  o Collar  object.  The  String  objects 
have  a collection  of  characters  and  the  Collar  objects  have  an  int. 


Serialization  saves  the 
entire  object  graph 
All  objects  referenced 
by  instance  variables, 
starting  with  tbe 
object  being  serialized. 


'e*)ne\  obi 


i to* 
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If  you  want  your  class  to  be  serializable, 
implement 


Serializable 


The  Serializable  interface  is  known  as  a marker  or  tag  interface, 
because  the  interface  doesn’t  have  any  methods  to  implement.  Its 
sole  purpose  is  to  announce  that  the  class  implementing  it  is,  well, 
serializable.  In  other  words,  objects  of  that  type  are  saveable  through 
the  serialization  mechanism.  If  any  superclass  of  a class  is  serializable, 
the  subclass  is  automatically  serializable  even  if  the  subclass  doesn’t 
explicitly  declare  implements  Serializable.  (This  is  how  interfaces  always 
work.  If  your  superclass  “IS-A”  Serializable,  you  are  too). 


objectOutputStream, writeObject (myBox) ; 


Tl\ \ W at  ^"'e' 


Ser'a' 


err 


\t  **' 


import  java.io.*; 


• tbe  \ava-'*«  yattay* 40 


public  class  Box  implements  Serializable  { 


No  wetbod*  to  '">?  )(  ^ 0VM» 

U’s  0*  to  serials  ^ ^ 


'private  int  width;  , 

private  int  height^/  ' tnese  two  values  will  t>e 


saved 


public  void  setWidth(int  w)  { 
width  * w; 

} 

public  void  setHeight (int  h)  { 
height  = h; 

) 

public  static  void  main  (String!]  args)  { 

Box  myBox  = new  Box() ; 
myBox. setWidth (50) ; 

myBox. satHaight (20)  ; |/0  oyeraW*  63*  tbrox  e*6«ft'° 


e— 1 *$£■■*■  **• 
■s  vw*1'- 


try  { 

FileOutputStream  fs  * new  FileOutputStreara("foo. ser")  ; 
ObjectOutputStream  os  = new  ObjectOutputStream(fs) ; 
os. writeObject (myBox) ; ^fake 

os. close ()  ; 

) catch (Exception  ex)  { 
ex . prints tackTrace ( ) ; 

} 


T'll  ,it  ^ ! W. 
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Serialization  is  all  or  nothing. 


Can  you  imagine  what  would 
happen  If  some  of  the  object’s 
state  didn’t  save  correctly? 


f*r 


Eeewww!  That 
creeps  me  out  just  thinking 
about  itl  Like,  what  if  a Dog  comes 
back  with  no  weight.  Or  no  ears.  Or 
the  collar  comes  back  size  3 instead 
of  30.  That  just  can  t be  allowed! 


import  java.io.*; 

public  class  Pond  implements  Serializable  { 
private  Duck  duck  = new  Duck<);  £— 


Pend  objects  Un  be  sev-ializedi 


C\a*  ?<**£*"* 
variaUe,  a 


public  static  void  main  (String []  args)  ( 

Pond  myPond  = now  Pond ( ) ; 
try  { 

FileOutputStream  fs  = new  FileOutputStream("Pond. ser")  ; 
Ob jectOutput Stream  os  = new  ObjeatOutputStream (f a) ; 


os . writeGbj act (myPond)  , 
os . close () ; 

} catch (Exception  ex)  { 
ex .prints tackTrace () ; 

) 


"f “d  <>  ^ 


Either  the  entire 
object  graph  is 
serialized  correctly 
or  serialization  fails. 

You  can’t  serialize 
a Pond  object  if 
its  Duck  instance 
variable  refuses  to 
be  serialized  (by 
not  implementing 
Serializable). 


public  class  Duck  { 
//  duck  code  here 

) 


W'/  f>«*k  ij  not  ievializab!*/ 

(t  implement 

$0  wKtfn  you  try  lo  ierialiic  d 

Pond  obiedt,  it  fa,lt  the 

Pond  $ Pu4k  initandc  variable 

C3h  t b«  saved- 


»ifl  Edft 


% java  Pond  . , , -ableEHceptioiv:  Duck 

iMi„  (Pond.  j.v.:13) 
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It’s  hopeless, 
then?  I'm  completely 
screwed  if  the  idiot  who 
wrote  the  class  for  my  instance 
variable  forgot  to  make  it 

o"-\ 

Serializable? 


Mark  an  Instance  variable  as  transient 
If  it  carft  (or  shouldn’t)  be  saved. 

If  you  want  an  instance  variable  to  be  skipped  by  the 
serialization  process,  mark  the  variable  with  the  transient 
keyword. 


SAIL  ^ . -.ust  M 

1*r!/***  variable' 

Will  bt  lived  as  pa>-t 
7 tte  object's  st^ 

flying  senali*a(y0hi 


import  java.net.*; 

class  Chat  implements  Serializable  { 
^ transient  String  currentID; 


String  userName; 


//  more  code 


* 


If  you  have  an  instance  variable  that  can't  be  saved  because 
it  isn't  serializable,  you  can  mark  that  variable  with  the 
transient  keyword  and  the  serialization  process  will  skip  right 


over  it 


So  why  would  a variable  not  be  serializable?  It  could  be 
that  the  class  designer  simply  forgot  to  make  the  class 
implement  Serializable.  Or  it  might  be  because  the  object 
relies  on  runtime-specific  information  that  simply  can't  be 
saved.  Although  most  things  in  the  Java  class  libraries  are 
serializable,  you  can't  save  things  like  network  connections, 
threads,  or  file  objects.  They're  all  dependent  on  (and 
specific  to)  a particular  runtime  'experience'.  In  other  words, 
they're  instantiated  in  a way  that's  unique  to  a particular  run 
of  your  program,  on  a particular  platform,  in  a particular 
JVM.  Once  the  program  shuts  down,  there's  no  way  to  bring 
those  things  back  to  life  in  any  meaningful  way;  they  have  to 
be  created  from  scratch  each  time. 
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If  serialization  is  so  important, 
why  isn't  it  the  default  for  all  classes? 
Why  doesn't  class  Object  implement 
Serializable,  and  then  all  subclasses 
will  be  automatically  Serializable. 

Even  though  most  classes  will, 
and  should,  implement  Serializable, 
you  always  have  a choice.  And  you 
must  make  a conscious  decision  on 
a class-by-class  basis,  for  each  class 
you  design,  to  'enable'  serialization 
by  implementing  Serializable. 

First  of  all,  if  serialization  were  the 
default,  how  would  you  turn  it  off? 
Interfaces  indicate  functionality,  not 
a lack  of  functionality,  so  the  model 
of  polymorphism  wouldn't  work 
correctly  if  you  had  to  say,"implements 
NonSerializable"to  tell  the  world  that 
you  cannot  be  saved. 


Why  would  I ever  write  a class 
that  wasn't  serializable? 

^Z  There  are  very  few  reasons,  but 
you  might,  for  example,  have  a security 
issue  where  you  don't  want  a password 
object  stored.  Or  you  might  have  an 
object  that  makes  no  sense  to  save, 
because  its  key  instance  variables  are 
themselves  not  serializable,  so  there's 
no  useful  way  for  you  to  make  your 
class  serializable. 


% If  a class  I'm  using  isn't 
serializable,  but  there's  no  good 
reason  (except  that  the  designer  just 
forgot  or  was  stupid),  can  I subclass 
the  'bad'  class  and  make  the  subclass 
serializable? 


Yes!  If  the  class  itself  is 
extendable  (i.e.  not  final),  you  can 
make  a serializable  subclass,  and  just 
substitute  the  subclass  everywhere 
your  code  is  expecting  the  superclass 
type.  (Remember,  polymorphism 
allows  this.)  Which  brings  up  another 
interesting  issue:  what  does  it  mean  if 
the  superclass  is  not  serializable? 

Q/  You  brought  it  up:  what  does  it 
mean  to  have  a serializable  subclass 
of  a non-serializable  superclass? 

^Z  First  we  have  to  look  at  what 
happens  when  a class  is  deserialized, 
(we'll  talk  about  that  on  the  next  few 
pages).  In  a nutshell,  when  an  object 
is  deserialized  and  its  superclass  is  not 
serializable,  the  superclass  constructor 
will  run  just  as  though  a new  object  of 
that  type  were  being  created.  If  there's 
no  decent  reason  for  a class  to  not 
be  serializable,  making  a serializable 
subclass  might  be  a good  solution. 

Q/  Whoal  I just  realized 
something  big...  if  you  make  a 
variable 'transient',  this  means  the 
variable's  value  is  skipped  over 
during  serialization. Then  what 
happens  to  it?  We  solve  the  problem 
of  having  a non-serializable  instance 
variable  by  making  the  instance 
variable  transient,  but  don't  we  NEED 
that  variable  when  the  object  is 
brought  back  to  life?  In  other  words, 
isn't  the  whole  point  of  serialization 
to  preserve  an  object's  state? 

Z Yes,  this  is  an  issue,  but 
fortunately  there's  a solution.  If  you 
serialize  an  object,  a transient  reference 
instance  variable  will  be  brought  back 


as  null,  regardless  of  the  value  it  had 
at  the  time  it  was  saved.That  means 
the  entire  object  graph  connected  to 
that  particular  instance  variable  won't 
be  saved.This  could  be  bad,  obviously, 
because  you  probably  need  a non-null 
value  for  that  variable. 

You  have  two  options: 

1)  When  the  object  is  brought  back, 
reinitialize  that  null  instance  variable 
back  to  some  default  state. This 
works  if  your  deserialized  object  isn't 
dependent  on  a particular  value  for 
that  transient  variable.  In  other  words, 
it  might  be  important  that  the  Dog 
have  a Collar,  but  perhaps  all  Collar 
objects  are  the  same  so  it  doesn't 
matter  if  you  give  the  resurrected  Dog 
a brand  new  Collar;  nobody  will  know 
the  difference. 

2)  If  the  value  of  the  transient  variable 
does  matter  (say,  if  the  color  and  design 
of  the  transient  Collar  are  unique  for 
each  Dog)  then  you  need  to  save  the 
key  values  of  the  Collar  and  use  them 
when  the  Dog  is  brought  back  to 
essentially  re-create  a brand  new  Collar 
that's  identical  to  the  original. 

What  happens  if  two  objects  in 
the  object  graph  are  the  same  object? 
Like,  if  you  have  two  different  Cat 
objects  in  the  Kennel,  but  both  Cats 
have  a reference  to  the  same  Owner 
object.  Does  the  Owner  get  saved 
twice?  I'm  hoping  not. 

Z Excellent  question!  Serialization 
is  smart  enough  to  know  when  two 
objects  in  the  graph  are  the  same.  In 
that  case,  only  one  of  the  objects  is 
saved,  and  during  deserialization,any 
references  to  that  single  object  are 
restored. 
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deserialization:  restoring  an  object 

The  whole  point  of  serializing  an  object  is  so  that  you  can 
restore  it  back  to  its  original  state  at  some  later  date,  in  a 
different  'run1  of  the  JVM  (which  might  not  even  be  the  same 
JVM  that  was  running  at  the  time  the  object  was  serialized) . 
Deserialization  is  a lot  like  serialization  in  reverse. 


Make  a FilelnputStream 


|UV.e 

1 ...  j.  ^'\\  cA  a* 


doesn't 


£ t+A  y* 

FilelnputStream  file  Stream  = new  FilelnputStream  ("MyGame.  ser")  ; 

r 


Moke  an  Object InputStream 

ObjectlnputStream  os  = new  Ob ject InputStream (files tream) ; 

bA  >t  aWL  to  a 


o read  the  objects 

Object  one  = os . readOb j ect ( ) ; 
Object  two  = os . readOb j ect () ; 
Object  three  = os. readOb j ect () ; 


Cost  the  objects 


GameCharacter  elf  — (GameCharacter)  one; 
GameCharacter  troll  = (GameCharacter)  two; 
GameCharacter  magician  = (GameCharacter) 


TVe  veW"  v3'ue 


i Ht  w.lV.  ArravL-^tJ, 

. 

IU  b/?e  1** 


,ew  really  ll- 


Close  the  ObjectlnputStream 

os . close  ( ) 

a 


&&$££$&£! 


Oh^s 

the 
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What  happens  during  deserialization? 


When  an  object  is  deserialized,  the  JVM  attempts  to  bring 
the  object  back  to  life  by  making  a new  object  on  the  heap 
that  has  the  same  state  the  serialized  object  had  at  the  time  it 
was  serialized.  Well,  except  for  the  transient  variables,  which 
come  back  either  null  (for  object  references)  or  as  default 
primitive  values. 


Q The  object  is  read  from  the  stream. 

^ The  JVM  determines  (through  info  stored  with 
the  serialized  object)  the  object's  class  type. 

^ The  JVM  attempts  to  find  and  load  the  ob- 
ject's class.  If  the  JVM  can't  find  and/or  load 
the  class,  the  JVM  throws  an  exception  and 
the  deserialization  fails. 

Q A new  object  is  given  space  on  the  heap,  but 
the  serialized  object's  constructor  does 
NOT  run!  Obviously,  if  the  constructor  ran,  it 
would  restore  the  state  of  the  object  back 
to  its  original  ’new'  state,  and  that's  not  what 
we  want.  We  want  the  object  to  be  restored 
to  the  state  it  had  when  it  was  serialized,  not 
when  it  was  first  created. 


-,Jt  the 


AW 


Object 
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^ If  the  object  has  a non-serial izable  class 
somewhere  up  its  inheritance  tree,  the 
constructor  for  that  non-serializable  class 
will  run  along  with  any  constructors  above 
that  (even  if  they're  serializable).  Once  the 
constructor  chaining  begins,  you  can't  stop  it, 
which  means  all  superclasses,  beginning  with 
the  first  non-serializable  one,  will  reinitialize 
their  state. 

Q The  object's  instance  variables  are  given  the 
values  from  the  serialized  state.  Transient 
variables  are  given  a value  of  null  for  object 
references  and  defaults  (0,  false,  etc.)  for 
primitives. 


V^/Why  doesn't  the  class  get  saved  as  part  of  the  ob- 
ject? That  way  you  don't  have  the  problem  with  whether 
the  class  can  be  found. 

A. 

*1- Sure,  they  could  have  made  serialization  work  that 
way.  But  what  a tremendous  waste  and  overhead.  And 
while  it  might  not  be  such  a hardship  when  you're  using 
serialization  to  write  objects  to  a file  on  a local  hard  drive, 
serialization  is  also  used  to  send  objects  over  a network 
connection.  If  a class  was  bundled  with  each  serialized 
(shippable)  object,  bandwidth  would  become  a much  larger 
problem  than  it  already  is. 

For  objects  serialized  to  ship  over  a network,  though,  there 
actually  is  a mechanism  where  the  serialized  object  can  be 
'stamped' with  a URL  for  where  its  class  can  be  found. This 
is  used  in  Java's  Remote  Method  Invocation  (RMl)  so  that 
you  can  send  a serialized  object  as  part  of,  say,  a method 


argument,  and  if  the  JVM  receiving  the  call  doesn't  have 
the  class,  it  can  use  the  URL  to  fetch  the  class  from  the 
network  and  load  it,  all  automatically.  (We'll  talk  about  RMl 
in  chapter  17.) 


A* 

r\m  Nope.  Remember,  static  means  "one  per  class"  not 
"one  per  object"  Static  variables  are  not  saved,  and  when  an 
object  is  deserialized,  it  will  have  whatever  static  variable 
its  class  currently  has. The  moral:  don't  make  serializable  ob- 
jects dependent  on  a dynamically-changing  static  variable! 
It  might  not  be  the  same  when  the  object  comes  back. 
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Saving  and  restoring  the  game  characters 

import  java.io.*; 

public  class  GameSaverTest  { Make  «>»e  tharat'U'rs-" 

public  static  void  main{String(]  args)  ( 

GameCharacter  one  = new  GameCharacter (50,  "Elf",  new  String{]  {"bow",  "sword",  "dust"}); 
GameCharacter  two  = new  GameCharacter (200,  "Troll",  new  String!]  ("bare  hands",  "big  ax"}); 
GameCharacter  three  = new  GameCharacter (120,  "Magician",  new  String []  ("spells",  "invisibility"}); 

//  imagine  code  that  does  things  with  the  characters  that  might  change  their  state  values 


try  { 

GbjectOutputStream  os  = new  ObjectOutputStream(new  FileOutputStream("Game.ser") ) ; 

os.writeObjact(one) ; 

os.writeObject(twoj ; 

os. writeObject( three) ; 

os.  closed  / 

) catch (IOException  ex)  { 
ex.printStackTraceO  ; 


one  = null;  iel  the*  kx>  Wnt 

two  = null;  ai(.eu  -the  objects  -th« 

three  = null; 

No*  read  the*  back  |n  the  ■file- 

try  { £ 

ObjectlnputStream  is  = new  ObjectlnputStream (new  FilelnputStream ("Game . ser") ) ; 
GameCharacter  oneRestore  = (GameCharacter)  is.readObject() ; 

GameCharacter  twoRestore  = (GameCharacter)  is.readQbject() ; 

GameCharacter  threeReatore  = (GameCharacter)  is.readObject() ; 


Systeo.out.println("One' s type:  " + oneRestore.getTypeO ) ; v ^ ^ ^ 

System, out. println ("Two' s type:  " + twoRestore . getType ()) ; ^ 


Troll 


+ threeRestore. getType () ) 


System. out, println ("Three' s type 
catch (Exception  ex)  ( 
ex  .prints tackTrace  () ; 


File  Edit  Window  Help  Resuscitate 
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The  (rameCharacter  class 


import  java.io.*; 

public  class  GameCharacter  implements  Serializable  { 
int  power; 

String  type; 

String []  weapons; 

public  GameCharacter (int  p,  String  t,  String[]  w)  { 
power  = p; 
type  = t; 
weapons  = w; 

} 


Seriated  **  ^ do«i  to*** 
you  io  e*f>  er'i*>e»t- 


public  int  getPower()  ( 
return  power; 

} 

public  String  getType()  { 
return  type; 

} 

public  String  getWeaponsQ  ( 

String  weaponList  = 

for  (int  i = 0;  i < weapons. length;  i++)  ( 
weaponList  +=  weapons [i]  + " "; 

} 

return  weaponList; 
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. BULLET  POINTS  

► You  can  save  an  object’s  state  by  serializing  the  object 

► To  serialize  an  object,  you  need  an  ObjectOutputStream  (from  the 
java.lo  package) 

► Streams  are  either  connection  streams  or  chain  streams 

► Connection  streams  can  represent  a connection  to  a source  or 
destination,  typically  a file,  network  socket  connection,  or  the 
console. 

► Chain  streams  cannot  connect  to  a source  or  destination  and  must 
be  chained  to  a connection  (or  other)  stream. 

► To  serialize  an  object  to  a file,  make  a FiteOuputStream  and  chain  it 
into  an  ObjectOutputStream. 

► To  serialize  an  object  call  writeObject(theObject)  on  the 
ObjectOutputStream.  You  do  not  need  to  call  methods  on  the 
FlleOutputStream. 

► To  be  serialized,  an  object  must  Implement  the  Serializable  interface. 
If  a superclass  of  the  class  Implements  Serializable,  the  subclass  will 
automatically  be  serializable  even  If  it  does  not  specifically  declare 
implements  Serializable. 

► When  an  object  is  serialized,  its  entire  object  graph  Is  serialized.  That 
means  any  objects  referenced  by  the  serialized  object’s  instance 
variables  are  serialized,  and  any  objects  referenced  by  those 
ob)eds...and  so  on. 

■ ► If  any  object  in  the  graph  Is  not  serializable,  an  exception  will  be 
thrown  at  runtime,  unless  the  Instance  variable  referring  to  the  object 
is  skipped. 

► Mark  an  instance  variable  with  the  transient  keyword  If  you  want 
serialization  to  skip  that  variable.  The  variable  will  be  restored  as  null 
(for  object  references)  or  default  values  (for  primitives). 

► During  deserialization,  the  class  of  alt  objects  In  the  graph  must  be 
available  to  the  JVM. 

► You  read  objects  in  (using  readObjectQ)  In  the  order  in  which  they 
were  originally  written. 

► The  return  type  of  readObjectO  is  type  Object,  so  deserialized 
objects  must  be  cast  to  their  real  type. 

>-  Static  variables  are  not  serialized!  It  doesn't  make  sense  to  save 
a static  variable  value  as  part  of  a specific  object’s  state,  since  all 
objects  of  that  type  share  only  a single  value— the  one  in  the  class. 
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Writing  a String  to  a Text  File 

Saving  objects,  through  serialization,  is  the  easiest  way  to  save  and 
restore  data  between  runnings  of  a Java  program.  But  sometimes  you 
need  to  save  data  to  a plain  old  text  hie.  Imagine  your  Java  program 
has  to  write  data  to  a simple  text  hJe  that  some  other  {perhaps  non- 
Java)  program  needs  to  read.  You  might,  for  example,  have  a servlet 
(Java  code  running  within  your  web  server)  that  takes  form  data  the 
user  typed  into  a browser,  and  writes  it  to  a text  file  that  somebody  else 
loads  into  a spreadsheet  for  analysis. 

Writing  text  data  (a  String,  actually)  is  similar  to  writing  an  object, 
except  you  write  a String  instead  of  an  object,  and  you  use  a 
FileWriter  instead  of  a FileOutputStream  (and  you  don't  chain  it  to  an 
ObjectOutputStream) . 

To  write  a serialized  object: 

ObjectOutputStream . wri teObject (someOb  ject) ; 

To  write  a String: 

fileWriter. write {"My  first  String  to  save") ; 


Mat  tke  tV&riLicr  data 
look  like  i-f  you  u/rote  it 
out  as  a hu»jn-v«adab)e  tt*t  -file. 
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writing  a text  file 


text  File  Example:  e-Flashcards 

Remember  those  flashcards  you  used  in  school?  Where  you 
had  a question  on  one  side  and  the  answer  on  the  back? 
They  aren't  much  help  when  you’re  trying  to  understand 
something,  but  nothing  beats  'em  for  raw  drill-and-practi.ee 
and  rote  memorization.  When  you  have  to  bum  in  a fact . And 
they’re  also  great  for  trivia  games. 

We’re  going  to  make  an  electronic  version  that  has  three 
classes: 

1)  QuizCardBuilder,  a simple  authoring  tool  for  creating  and 
saving  a set  of  e-Flashcards. 


2)  QuixCardPtayer,  a playback  engine  that  can  load  a 
flashcard  set  and  play  it  for  the  user. 

3)  QuizCard,  a simple  class  representing  card  data.  We’ll 

walk  through  the  code  for  the  builder  and  the  player,  and 
have  you  make  the  QuizCard  class  yourself,  using  this  


A&SL 


Cvd  Builder 


File 


Question; 


{Which  university  is  featured  in  the 
film  "Good  Will  Hunting*? 


IM.I.T. 


f hotCrt'j 


QuizCard 


QulzCard(q,  a) 


question 

answer 


getQuestianO 

getAnswerQ 


sm: 


frite  Card  Player 


Fite 


E^at  happens  If  you  call 
DbjectgetPrimaryKeyO  on  a 
sion  bean's  remote  reference? 


f ShomAitwHf  ) 


QuizCard  Builder 

Has  a File  menu  with  a "Save"  option  for  saving 
the  current  set  of  cards  to  a text  file. 


QuIzCardPlayer 

Has  a File  menu  with  a "Load"  option  for  loading  a 
set  of  cards  from  a text  file. 
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Quiz  Card  Builder  (code  outline) 

public  class  QuizCardBuilder  { 


public  void  go()  { 

//  build  and  display  gui 


guilds  and  displays 
making  and  Tt^sXt 


rw$  event  listeners. 


Inner  dlass 

private  class  N extCardLis  tener  implements  ActionListener  { 
public  void  actionPerformed(ActionEvent  ev)  { 

//  add  the  current  card  to  the  list  and  clear  the  text  areas 

} 


Cav-a’  Wtton; 


} 


[nncv  dlass 

private  class  SaveMenulistener  implements  ActionListener  { 
public  void  actionPerformed(ActionEvent  ev)  { 

//  bring  up  a file  dialog  box 
//  let  the  user  name  and  save  the  set 

) 

} 


ihc  dards  ih  t save 

Java  ^u(es,  g^.,1  ***  ltollY*°°d  Trivia, 


Inner  dlass 

private  class  N e wMenuListener  implements  ActionListener  { 
public  void  actionPerformed(ActionEvent  ev)  { 

/ / clear  out  the  card  list,  and  clear  out  the  text  areas 

} 

} 


......  ‘New 


private  void  saveFile(File  file)  { 

//  iterate  through  the  list  of  cards,  and  write  each  one  out  to  a text  file 
//  in  a parseahle  way  (in  other  words,  with  clear  separations  between  parts) 

} 

Called  ty  the  SaveMen*Ustenen; 
does  tHe  actual  tile  veritmj. 
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Quiz  Card  Builder  code 


import  java. util.*; 
import  java.awt. event.*; 
import  javax. swing. *; 
import  java.awt.*; 
import  java.io.*; 

public  class  QuizCardBuilder  { 

private  JTextArea  question; 
private  JTextArea  answer; 
private  ArrayList<QuizCard>  cardList; 
private  JFrame  frame; 


public  static  void  main  (String []  args)  { 

QuizCardBuilder  builder  = new  QuizCardBuilder () ; 
builder. go () ; 

} 


public  void  go()  { 

//  build  gui 

frame  = new  JFrame ("Quiz  Card  Builder"); 

JPanel  mainPanel  = new  JPanelf); 

Font  bigFont  = new  Font ("sanserif".  Font. BOLD,  24); 
question  = new  JTextArea (6, 20) ; 
question. setLineWrap (true) ; 
question . setWrapStyleWord (true) ; 
question. setFont (bigFont) ; 

JScrollPane  qScroller  = new  JScrollPane (question) ; 
qScroller. setVerticalScrollBarPolicy ( Scroll PaneCons tan ts . VERTICAL_SCROLLBAR_ALWAYS ) ; 
qScroller. setHorizontalScrollBarPolicy (ScrollPaneConstants . HORIZONTAL_SCROLLBAR_NEVER) ; 

answer  = new  JTextArea (6, 20) ; 
answer. setLineWrap (true) ; 
answer. setWrapStyleWord (true) ; 
answer . setFont (bigFont)  ; 

JScrollPane  aScroller  = new  JScrollPane (answer) ; 

aScroller .setVerticalScrollBarPolicy (ScrollPaneConstants . VERT I CAL_SCROLLBAR_ALWAY S ) ; 
aScroller .setHorizontalScrollBarPolicy ( ScrollPaneConstants. HORIZONTAL_SCROLLBAR_NEVER) ; 


H wan 


JButton  nextButton  = new  JButton ("Next  Card"); 

cardList  = new  ArrayList<QuizCard> () ; 

JLabel  qLabel  = new  JLabel ("Question: ") ; 

JLabel  aLabel  = new  JLabel ("Answer:") ; 

mainPanel. add (qLabel) ; 
mainPanel. add (qScroller) ; 
mainPanel. add (aLabel) ; 
mainPanel. add (aScroller)  ; 
mainPanel . add (nextButton) ; 

nextButton. addActionListener (new  NextCardListener ( ) ) ; 
JMenuBar  menuBar  = new  JMenuBar ( ) ; 

JMenu  fileMenu  = new  JMenu  ("File")  ; 

JMenuItem  newMenuItem  = new  JMenuItem ("New") ; 
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) 


JMenuItem  saveMenuItem  = new  JMenuItem('vSave"); 
newMenuItem. addActionListener (new  NewMenuListener ( ) ) ; 

saveMenuItem. addActionListener (new  SaveMenuListener () ) 
fileMenu. add  (newMenuItem) ; 
fUeMenu.add (saveMenuItem) / 

menuBar.  add  (fileMenu) ; n*hu  b, 

frame. setJMenuBar (menuBar) ; P 

frame. getContentPane () .add (BorderLayout. CENTER,  mainPanel) ; ,ontl 

frame.  setSize  (500, 600) ; 
frame . setVisible (true) ; 


ptr£  vij* 1 * File 

?""*  U*c  - J A Vdd  tte 
■ 't'**'  kll  ihe 

Fr  Mr-  We»u 


public  class  NextCardListener  Implements  ActionListener 

public  void  actionPerformed (ActionEvent  ev)  { 


) 


QuizCard  card  = new  QuizCard (question .getText () , answer .getText  ()) ; 
cardlist. add (card) ; 
clearCardO  ; 


public  class  SaveMenuListener  implements  Actionlistaner  { 

public  void  actionPerformed (ActionEvent  ev)  ( 

QuizCard  card  = new  QuizCard(question . getText () , answer .getText 0 ) ; 
cardList.add(card) ; ^ ^ 


JFileChooser  flleSave  = new  JFileChooser  () ; 

flleSave.  showSaveDialog  (frame) ; 

saveFile  (flleSave  * get SelectedFile  0 ) ; ( 


public  class  NewMenuListener  implements  Actionlistaner  { 

public  void  actionPerformed (ActionEvent  ev)  { 
cardList.clear () ; 


} 


) 


clearCardO  ; 


private  void  clearCardO  ( 
question.setText (u") ; 
answer.  setText  (“")  ; 
question.  requestFocus  () ; 

) 


{ 


private  void  saveFile  (File  file) 
try  { 

BufferedWriter  writer  = new  BufferedWriter (new  FileWriter (file) ) ; 


for (QuizCard  card: cardlist)  ( 

writer  .write  (card.getQuestion  ()  + V")  ; 
writer. write ( card. get Answer ()  + *\n") ; 

) 

writer .close () ; 


) catch  (IOException  ex)  { 

System. out. println("couldn' t write  the  cardList  out") ; 
ex.printStackTrace  () ; 

} 


^iu.ik.uttksr^reP^it"t 

JValk  ttrtuji,  AwayLiH 

p* ««.  ;;;  f*d 

‘»<r  lentil, I by  . ■/* 
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The 


java.io.File 


class 


The  java.io.File  class  represents a file  on  disk,  but  doesn’t 
actually  represent  the  contents  of  the  file.  What?  Think  of 
a File  object  as  something  more  like  a pathname  of  a file 
(or  even  a directory)  rather  than  The  Actual  File  Itself. 
The  File  class  does  not,  for  example,  have  methods  for 
reading  and  writing.  One  VERY  useful  thing  about  a File 
object  is  that  it  offers  a much  safer  way  to  represent  a 
file  than  just  using  a String  file  name.  For  example,  most 
classes  that  take  a String  file  name  in  their  constructor 
(like  FileWriter  or  FilelnputStream)  can  take  a File 
object  instead.  You  can  construct  a File  object,  verify 
that  you've  got  a valid  path,  etc.  and  then  give  that  File 
object  to  the  FileWriter  or  FilelnputStream. 


A File  object  represents  the  name 
and  path  of  a file  or  directory  on 
disk,  for  example: 

/Users/Kathy/Data/GameFile.txt 

But  it  does  NOT  represent,  or  give 
you  access  to,  the  data  in  the  filel 


Some  things  you  can  do  with  a File  object: 

$ Make  a File  object  representing  an 
existing  file 

File  f = new  File ("MyCode.txt") ; 

@ Make  a new  directory 

File  dir  = new  File ("Chapter?") ; 
dir.mkdir  () ; 


® List  the  contents  of  a directory 

if  (dir.isDirectory() ) { 

String!]  dirContents  = dir.listO; 
for  (int  i = 0;  i < dirContents. length;  iH) 
System. ou t.println(dirCon ten ts[i])  ; 

} 

} 


® Set  the  absolute  path  of  a file  or  directory 
Sys  tern . out . pr intin (dir . getAbsolutePath ( ) ) ; 


@ Delete  a file  or  directory  (returns  true  If 
successful) 

boolean  isDeleted  = f. delete (); 
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serialization  and  file  I/O 


The  beauty  of  buffers 

If  there  were  no  buffers,  it  would  be  like 
shopping  without  a cart.  You'd  have  to 
carry  each  thing  out  to  your  car,  one  soup 
can  or  toilet  paper  roll  at  a time. 


X 


works  with  characters)  that  writes  characters 

as  opposed  to  bytes) 


BufferedWriter  writer  = new  Buf feredWriter (new  FileWriter (aFile) ) , 


The  cool  thing  about  buffers  is  that  they  Ye  muchm  ore  efficient  than 
working  without  them.  You  can  write  to  a file  using  FileWriter  alone,  by 
calling  write(someStxing),  but  FileWriter  writes  each  and  every  thing  you 
pass  to  the  file  each  and  every  time.  That's  overhead  you  don’t  want  or 
need,  since  every  trip  to  the  disk  is  a Big  Deal  compared  to  manipulating 
data  in  memory.  By  chaining  a BufferedWriter  onto  a FileWriter,  the 
BufferedWriter  will  hold  all  the  stuff  you  write  to  it  until  it's  full.  Only  when 
the  buffer  is  full  will  the  FileWriter  actually  be  told  to  write  to  the  file  on  disk. 


, / he 

a* 


If  you  do  want  to  send  data  before  the  buffer  is  full,  you  do  have  control. 
Just  Flush  It  Calls  to  writer.flushQ  say,  "send  whatever's  in  the  buffer, 
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Reading  from  a text  File 

Reading  text  from  a file  is  simple,  but  this  time  we’ll  use  a File 
object  to  represent  the  file,  a FileReader  to  do  the  actual  reading, 
and  a BufferedReader  to  make  the  reading  more  efficient. 

The  read  happens  by  reading  lines  in  a while  loop,  ending  the  loop 
when  the  result  of  a readUuae()  is  null.  That's  the  most  common 
style  for  reading  data  (pretty  much  anything  that’s  not  a Serialized 
object) : read  stuff  in  a while  loop  (actually  a while  loop  test} , 
terminating  when  there’s  nothing  left  to  read  (which  we  know 
because  the  result  of  whatever  read  method  we’re  using  is  null). 


import  j ava . io . : 


h -Pile  wrtk  -two  lines  text 


MyText.txt 


class  ReadAFile  { 

public  static  void  main  (String[]  args)  { 


try  { s~ 

File  myFile  = new  File ("MyText.txt") ; / 

FileReader  fil eReader  = new  FileReader  (myFile)  ; 


£ kw,  that  c^etis  ^ a te*t  (-le 


BufferedReader  reader  = new  BufferedReader (fileReader) ; 


String  line  = null; 


while  ((line  = reader . readLine () ) !=  null)  ( 

System. out .println (line) ; 

} \ «ys,  "Rei 

reader , close  ( ) ; ^VtIm 


} catch (Exception  ex)  ( 

ex.printStackTrace () ; 


Stf.hg  variable  ‘line'.  .^3"  i4  t»  the 

there  Wfc  JS™*  « ««t  null 

,,B*  ^ **  j«t  read."  3 ^ te3d)  f*'"l  out  the 

*****  ^ ^ W* 
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Quiz  Card  Player  (code  outline) 

public  class  QuizCardPlayer  { 

public  void  go()  { 

//  build  and  display  gui 

} 

class  NextCardlistener  implements  ActionListener  { 
public  void  actionPerformed  (ActionEvent  ev)  { 

//  if  this  is  a question,  show  the  answer,  otherwise  show  next  question 
//  set  a flag  for  whether  we’re  viewing  a question  or  answer 

} 

} 

class  OpenMenuListener  implements  ActionListener  { 
public  void  actionPerformed  (ActionEvent  ev)  { 

//  bring  up  a file  dialog  box 

//  let  the  user  navigate  to  and  choose  a card  set  to  open 

} 

} 

private  void  loadFile(File  file)  { 

//  must  build  an  ArrayList  of  cards,  by  reading  them  from  a text  file 
//  called  from  the  OpenMenuListener  event  handler,  reads  the  file  one  line  at  a time 
//  and  tells  the  makeCardQ  method  to  make  a new  card  out  of  the  line 
//  (one  line  in  the  file  holds  both  the  question  and  answer,  separated  by  a V”) 

} 


private  void  makeCard(String  lineToParse)  { 

//  called  by  the  loadFile  method,  takes  a line  from  the  text  file 

//  and  parses  into  two  pieces — question  and  answer — and  creates  a new  QuizCard 

//  and  adds  it  to  the  ArrayList  called  CardList 

} 
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Quiz  Card  Player  code 


import  java. util.*; 
import  j ava . awt . event . * ; 
import  javax. swing. *; 
import  java.awt.*; 
import  java.io.*; 

public  class  QuizCardPlayer  { 

private  JTextArea  display; 
private  JTextArea  answer; 
private  ArrayList<QuizCard>  cardList; 
private  QuizCard  currentCard; 
private  int  currentCardlndex; 
private  JFrame  frame; 
private  JButton  nextButton; 
private  boolean  isShowAnswer; 


public  static  void  main  {String!'] 

QuizCardPlayer  reader  = new  QuizCardPlayer () ; 
reader. go () ; 

} 

public  void  go()  { 

//  build  gui 

frame  = new  JFrame ("Quiz  Card  Player"); 

JPanel  mainPanel  = new  JPanelO; 

Font  bigFont  = new  Font ("sanserif",  Font. BOLD,  24); 

display  = new  JTextArea (10, 20) ; 
display. setFont (bigFont) ; 

display. setLineWrap  (true) ; 
display. setEditable (false) ; 

JScrollPane  qScroller  = new  JScrollPane (display) ; 

qScroller . setVerticalScrollBarPolicy (ScrollPaneConstants ,VERTICAL_SCROLLBAR_ALWAYS) ; 
qScroller . setHorizontalScrollBarPolicy (ScrollPaneConstants .HORIZONTAL_SCROLLBAR_NEVER) ; 
nextButton  = new  JButton ("Show  Question"); 
mainPanel. add (qScroller)  ; 
mainPanel . add (nextButton) ; 

nextButton. addActionListener (new  NextCardListener () ) ; 

JMenuBar  menuBar  = new  JMenuBar{); 

JMenu  fileMenu  = new  JNenu  ("File") ; 

JMenuItem  loadMenuItem  = new  JMenuItem ("Load  card  set"); 
loadMenuItem. addActionListener (new  OpenMenuListener () ) ; 
fileMenu . add  ( loadMenuItem)  ; 
menuBar  .add  (fileMenu) ; 
frame . set JMenuBar (menuBar) ; 

frame. getContentPane () . add (BorderLayout. CENTER,  mainPanel) ; 
frame. setSize (640,500)  ; 
frame . setVisible (true) ; 

} //  close  go 


rs)  { 


Kothmj  special 
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public  (Hass  NextCardListanar  implements  ActionListener  ( 
public  void  actionPer formed (Act ionEvent  ev)  { 
if  (isShowAnswer)  { 

//  show  the  answer  because  they've  seen  the  question 
display .setText (currentCard. getAnswer {) ) ; 
nextButton * setText  ("Next  Card7') ; 
isShowAnswer  = false; 

} else  { 

//  show  the  next  question 
if  (currentCardlndex  < cardList . size () ) { 


showNextCard () ; 


Z dn  a»d  doZ  , J**  3 Vttfcio* 


) else  { 

//  there  are  no  more  cards' 
display* setText ("That  was  last  card"); 
nextButton. setEnabled (false) ; 


public  class  OpenMenuListanar  implements  ActionListener 
public  void  actionPerformed (ActionEvent  ev)  { 
JFileChooser  fileOpen  = new  JFileChooser  () ; 

^ fileOpen . showOpenDialog  (frame) ; 
r v loadfile  (fileOpen.  getSelectedFile  () ) ; 

) 


) 


private  void  loadFile (Fila  file) 


{ 


[\\t  d«a\o*}»* 

.A  /Mtxne  tM 


3rA  \ei 

(iU  to 


cardList  = new  ArrayList<QuizCard> () ; 
try  ( 


private  void  maJteCard (String  linaToParse)  ( ^ 

String!)  result  = lineToParse. split ("/") ; 

QuizCard  card  = new  QuizCard (result [0] , re$ult[l]); 
cardList . add (card) ; 

System. out. println ("made  a card"); 


private  void  showNextCard  ()  ( 

currentCard  = cardList . get (currentCardlndex) ; 
CurrentCardIndex++; 

display . setText ( currentCard. getQuestion  () ) ; 
nextButton . setText ("Show  Answer") ; 
isShowAnswer  = true; 

} 

//  close  class 


W oi  t**t  is  to  i 

UYd,  tut  **  ta««  -to  par*  out  the 
jor  ard  answer  as  senate  fjetes.  We 
U SW  sflitO  -ettod  to  b^reak  the 

«to  two  W (**  ***»«  Tfr 

vr*  $ or  th*  awcr).  Well  look  W 
0 thod  on  the  Mfrk, 
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Parsing  with  String  splitO 


Imagine  you  have  a flashcard  like  this: 


Saved  in  a question  file  like  this: 
— 

What  is  blue  + yellow?/green 
What  is  red  + blue?/purple 


How  do  you  separate  the  question  and  answer? 

When  you  read  the  file,  the  question  and  answer  are  smooshed 
together  in  one  line,  separated  by  a forward  slash  V"  (because 
that's  how  we  wrote  the  file  in  the  QuizCardBuilder  code). 


String  split()  lets  you  break  a String  into  pieces. 

The  split()  method  says,  "give  me  a separator,  and  I'll  break  out  oil 
the  pieces  of  this  String  for  you  and  put  them  in  a String  array.' 


LWkatis  blu^ 

token  1 


9 


separator  token 


String  toTest  - "What  is  blue  + yellow?/green"; 
String []  result  = toTest. split ("/") ; 
for  (String  token: result)  { 

Sys tem. out. println (token) ; 

i ^ 


i.  tt.  ‘ 

■«  what  a (,\e. 

wW  Mr**"  *'le 


pi  ties,  ipli  {o'uV/iR  iV° 

what  weVe  usiZ  it  Tf  ^ 

parsing  with  Sir'1* 
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dSSGTJS 


uestipns 


I look  In  the  API  and  there  are  about  five 
million  classes  In  the  java  Jo  package.  How  the  heck  do  I - .*  -I 
you  know  which  ones  to  use?  [ * v 


A:i 


L-Ihe  I/O  API  uses  the  modular'chaining'concept  so 
that  you  can  hook  together  connection  streams  and  chain 
streams  (also  called  'filter'  streams)  in  a wide  range  of 
combinations  to  get  just  about  anything  you  could  want. 

The  chains  don't  have  to  stop  at  two  levels;  you  can  hook 
multiple  chain  streams  to  one  another  to  get  just  the  right 
amount  of  processing  you  need. 

Most  of  the  time,  though,  you'll  use  the  same 
small  handful  of  classes.  If  you're  writing  text  flies, 
BufferedReader  and  BufferedWriter  (chained  to  FjleReader 
and  FileWriter)  are  probably  ail  you  need  If  you're  writing 
serialized  objects,  you  can  use  ObjectOutputStream  and 
ObJectlnputStream  (chained  to  FilelnputStream  and 
FileOutputStream). 

In  other  words,  90%  of  what  you  might  typically  do  with 
Java  I/O  can  use  what  we've  already  covered. 


•What  about  the  new  I/O  nlo  classes  added  In  1.4? 


A: 


•The  java. nio  classes  bring  a big  performance 
improvement  and  take  greater  advantage  of  native 
capabilities  of  the  machine  your  program  Is  running 
on.  One  of  the  key  new  features  of  nlo  is  that  you  have 
direct  control  of  buffers.  Another  new  feature  Is  non- 
blocking I/O,  which  means  your  I/O  code  doesn't  just  sit 
there,  waiting,  if  there's  nothing  to  read  or  write.  Some 
of  the  existing  classes  (Including  FilelnputStream  and 
FileOutputStream)  take  advantage  of  some  of  the  new 
features,  under  the  covers.  The  nio  classes  are  more 
complicated  to  use,  however,  so  unless  you  really  need  the 
new  features,  you  might  want  to  stick  with  the  simpler 
versions  we've  used  here,  Plus,  If  you're  not  careful,  nio  can 
lead  to  a performance  /oss.Non-nio  I/O  is  probably  right 
for  90%  of  what  you'll  normally  do,  especially  if  you're  Just 
getting  started  In  Java. 

But  you  can  ease  your  way  into  the  nlo  classes,  by  using 
FilelnputStream  and  accessing  Its  channel  through  the 
getChannelfl  method  (added  to  FilelnputStream  as  of 
version  1 .4). 


To  write  a text  file,  start  with  a FileWriter 
connection  stream. 

Chain  the  FileWriter  to  a BufferedWriter  for 
efficiency. 

A File  object  represents  a file  at  a particular 
path,  but  does  not  represent  the  actual 
contents  of  the  file. 

With  a File  object  you  can  create,  traverse, 
and  delete  directories. 

Most  streams  that  can  use  a String  filename 
can  use  a File  object  as  well,  and  a File  object 
can  be  safer  to  use. 

To  read  a text  file,  start  with  a FleReader 
connection  stream. 

Chain  the  FileReader  to  a BufferedReader  for 
efficiency. 

To  parse  a text  file,  you  need  to  be  sure  the 
file  is  written  with  some  way  to  recognize  the 
different  elements.  A common  approach  is  to 
use  some  kind  of  character  to  separate  the 
individual  pieces. 

Use  the  String  sptltQ  method  to  spilt  a String 
up  into  individual  tokens.  A String  with  one 
separator  will  have  two  tokens,  one  on  each 
side  of  the  separator.  The  separator  doesn't 
count  as  a token. 
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saving  objects 

Version  IP;  A Pig  Serialization  Ooteha 

Now  you've  seen  that  I/O  in  Java  is  actually  pretty  simple,  especially  if 
you  stick  to  the  most  common  connection/chain  combinations.  But 
there’s  one  issue  you  might  really  care  about 

Version  Control  is  crucial! 

If  you  serialize  an  object,  you  must  have  the  class  in  order  to 
deserialize  and  use  the  object.  OK,  that’s  obvious.  But  what  might 
be  less  obvious  is  what  happens  if  you  change  the  class  in  the 
meantime?  Yikes.  Imagine  trying  to  bring  back  a Dog  object  when 
one  of  its  instance  variables  (non-transient)  has  changed  from  a 
double  to  a String.  That  violates  Java’s  type-safe  sensibilities  in  a Big 
Way.  But  that’s  not  the  only  change  that  might  hurt  compatibility. 
Think  about  the  following: 


Changes  to  a class  that  can  hurt  deserialization: 

Deleting  an  instance  variable 

Changing  the  declared  type  of  an  instance  variable 

Changing  a non-transient  instance  variable  to  transient 

Moving  a class  up  or  down  the  inheritance  hierarchy 

Changing  a class  (anywhere  in  the  object  graph)  from  Serializable 
to  not  Serializable  (by  removing  ‘implements  Serializable’  from  a 
class  declaration) 

Changing  an  instance  variable  to  static 


Changes  to  a class  that  are  usually  OK: 

Adding  new  instance  variables  to  the  class  (existing  objects  will 
deserialize  with  default  values  for  the  instance  variables  they  didn’t 
have  when  they  were  serialized) 

Adding  classes  to  the  inheritance  tree 

Removing  classes  from  the  inheritance  tree 

Changing  the  access  level  of  an  instance  variable  has  no  affect  on 
the  ability  of  deserialization  to  assign  a value  to  the  variable 

Changing  an  instance  variable  from  transient  to  non-transient 
(previously-serialized  objects  will  simply  have  a default  value  for  the 
previously-transient  variables) 


£ You  write  a bog  class 

tfc*  or.  tP 

Dog.class 


lonoi. 
nmol 
101010000 10 
1.010  10  0 
01010  1 
1010101 
10101010 
1001010101 


You  serialize  a Dog  object 
using  that  class 


bog 


Q You  change  the  Dog  class 

Class  version  lt> 

#12-0 


101101 

101101  “ 
101000010 
1010  10  0 
01010  1 
100001  1010 
0 00110101 
|1  0 1 10  10 


Dog.class 


A You  deserialize  a Dog  object 
using  the  changed  class 


r 

stamped  With 
version  #V^ 


101101 
101101 
101000010 
1010  10  0 
01010  1 
100001  1010 
0 00110101 
1 0 1 10  10 


Dog.class 


t\ass  version 

#12-0 


is 


£ Serailization  fails!! 

The  JVM  says,  “you  can't 
teach  an  old  Dog  new  code". 
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Using  the  serfalVersionUIP 

Each  time  an  object  is  serialized  the  object  (including 
every  object  in  its  graph)  is  'stamped1  with  a version 
ED  number  for  the  object’s  class.  The  ID  is  called 
the  serialVersionUID,  and  it’s  computed  based  on 
information  about  the  class  structure.  As  an  object  is 
being  deserialized,  if  the  class  has  changed  since  the 
object  was  serialized,  the  class  could  have  a different 
serialVersionUID,  and  deserialization  will  fail!  But  you 
can  control  this. 

If  you  think  there  Is  ANY  possibility  that 
your  class  might  evolve,  put  a serial  version 
ID  In  your  class. 

When  java  tries  to  deserialize  an  object,  it  compares 
the  serialized  object's  serialVersionUID  with  that  of  the 
class  the  JVM  is  using  for  deserializing  the  object  For 
example,  if  a Dog  instance  was  serialized  with  an  ID  of, 
say  23  (in  reality  a serialVersionUID  is  much  longer), 
when  the  JVM  deserializes  the  Dog  object  it  will  first 
compare  the  Dog  object  serialVersionUID  with  the 
Dog  class  serialVersionUID.  If  the  two  numbers  don't 
match,  the  JVM  assumes  the  class  is  not  compatible 
with  the  previously-serialized  object,  and  you’ll  get  an 
exception  during  deserialization. 

So,  the  solution  is  to  put  a serialVersionUID 
in  your  class,  and  then  as  the  class  evolves,  the 
serialVersionUID  will  remain  the  same  and  the  JVM 
will  say,  "OK,  cool,  the  class  is  compatible  with  this 
serialized  object."  even  though  the  class  has  actually 
changed. 

This  works  only  if  you’re  careful  with  your  class 
changes!  In  other  words,  you  are  taking  responsibility 
for  any  issues  that  come  up  when  an  older  object  is 
brought  back  to  life  with  a newer  class. 

To  get  a serialVersionUID  for  a class,  use  the  serialver 
tool  that  ships  with  your  Java  development  kit. 


When  you  think  your  class 
might  evolve  after  someone  has 
serialized  objects  from  It... 

Use  the  serialver  command-line  tool 
to  get  the  version  lb  for  your  class 

| Fife  Edrt  Windo*  Help  sarialKller  | 


%:  serialver  Dog 

Dog : static  final  long 
serialVersionUID  = - 
5849794470654667210L; 


(JP  Paste  the  output  into  your  class 
public  class  Dog  { 


static  final  long  iierialVarsiontntD  * 
-68497944707546677101*; 

private  String  name; 
private  int  size; 

//  method  code  here 

) 


^ Be  sure  that  when  you  moke  changes  to 
the  class,  you  take  responsibility  in  your 
code  for  the  consequences  of  the  changes 
you  made  to  the  class!  For  example,  be 
sure  that  your  new  bog  class  can  deal  with 
an  old  bog  being  deserialized  with  default 
values  for  instance  variables  added  to  the 
class  after  the  bog  was  serialized. 
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Code  Kitchen 


* ^ 

Code  Kitchen 


see 


Cyber  BeatBox 


Bass  Drum  □□□□□□HODDDgOQDOf  SUft  ) 

Closed Hl-Hat  □ □ i □□□□□□Q □□□gQ D(  Stop 
Open  Hl-Hat  □□□□□□□□□□□□□  ' v 

Acoustic  Snare 0-0 Q O 0000000000  DCS===U 
Crash  Cymbal  □□SSQQOQgODDDGOO^=^-' J' 

Hand  Clap  GOO  G □ GO  0000000  Tlflf  seriallztlt  ) K\ 
gGGGQGDOOGDGGGaQf  restore 
0000000000000000 
OGOQdOagUaQDDOQO 


High  Tom 
HI  Bongo 
Maracas 
Whistle 

LowConga  OOQOOOOOOOOQO0QB 

• cowbell  QQgOQQOOQgg00GgO 

Vibraslap  QGGGQGGGDGSOGGGG 

Low-mid  Tom  QG  □ Q G G □ O G G G G 0 G SO 

-High  Agogo  Q g □ □ 0*0000 O g G G G G 

Open  HI  CongaO  G G G O G O O G G C G G Q G O 

•  ■ d 


/V./V 

be  s^td 
vhc  elicit  bones. 


Let’s  malce  tke  BeatBox  save  and 
restore  our  favorite  pattern 
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Saving  a PeatPox  pattern 

Remember,  in  the  BeatBox,  a drum  pattern  is  nothing  more  than  a bunch  of 
checkboxes.  When  it’s  time  to  play  the  sequence,  the  code  walks  through  the 
checkboxes  to  figure  out  which  drums  sounds  are  playing  at  each  of  the  16 
beats.  So  to  save  a pattern,  all  we  need  to  do  is  save  the  state  of  the  checkboxes. 

We  can  make  a simple  boolean  array,  holding  the  state  of  each  of  the  256 
checkboxes.  An  array  object  is  serializable  as  long  as  the  things  in  the  array  are 
serializable,  so  we’ll  have  no  trouble  saving  an  array  of  booleans. 

To  load  a pattern  back  in,  we  read  the  single  boolean  array  object  (deserialize 
it),  and  restore  the  checkboxes.  Most  of  the  code  you’ve  already  seen,  in  the 
Code  Kitchen  where  we  built  the  BeatBox  GUI,  so  in  this  chapter,  we  look  at 
only  the  save  and  restore  code. 

This  CodeKitchen  gets  us  ready  for  the  next  chapter,  where  instead  of  writing 
the  pattern  to  a file,  we  send  it  over  the  network  to  the  server.  And  instead  of 
loading  a pattern  in  from  a file,  we  get  patterns  from  the  server , each  time  a 
participant  sends  one  to  the  server. 


Serializing  a pattern 


T«S  is  3*  >nn«v  t\ ass  M dt 
the  BealBo*  toil 


public  class  MySendListener  implements  ActionListener  { 
public  void  actionPerf orraed (ActionEvent  a)  { 

boolean []  checkboxState  = new  boolean [256] ; 
for  (int  i = 0;  i < 256;  i++)  { 


l-t  ail  topper*  vA>en  the  *ec 
button  and  the  Mtionfcvent 


} 


JCheckBox  check  = (JCheckBox)  checkboxList.get(i) ; Wall/  J-l  . 




if  (check. isSelected() ) { 
checkboxState [i]  = true; 

1 


try  { 

FileOutput Stream  file Stream  = new  FileOutputStream(new  File ("Checkbox. ser") ) ; 
ObjectOutputStream  os  = new  Ob j ec tOutputStr earn  (fileS tr earn)  ; 
os. writeObject (checkboxState) ; f 

} catch  (Exception  ex)  { Pi*e  ^ 


ex . prints tackTrace ( ) ; 


) 


} //  close  method 
} //  close  inner  class 
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Restoring  a Peattox  pattern 

This  is  pretty  much  the  save  in  reverse..,  read  the  boolean  array  and  use  it 
to  restore  the  state  of  the  GUI  checkboxes.  It  all  happens  when  the  user  hits 
the  “restore*  ‘button. 


Restoring  a pattern 


TMs  «**£*«; 
iwidc  d***- 


public  class  MyRaadlnListener  implements  Act! chIlIs tana r { 

public  void  actionPerformed (ActionEvent  a)  { 
boolean []  checkboxState  = null; 
try  { 

FilelnputStream  fileln  - new  FilelnputStxemn (new  File(vvCheckbox.ser")); 
ObjectlnputStream  is  * new  Ob  jectlnputStr earn  (fileln)  ; 
checkboxState  = (boolean  [ ] ) is . readObject  ()  ; 


} cat ah (Exception  ex)  { ex . printStxckTrace ( ) ; ) 


Read  Ue  M*  ho  a 

boolcfr  oti  i 


for  (int  i = 0;  i < 256;  i++>  ( 
JCheckBox  check  = (JCheckBox) 
if  (checkboxState [i])  { 

check . satSelacted ( true) ; 

) else  ( 

check. setSelected (false) ; 

) 


aheakboxList .get(i) ; 

Jtxir'  ^ **?*•  •f  «>■  tk. 

tju  2 tt'  *’;•>'-«  j iitui 


sequencer . stop ( ) ; 
buildTrackAndStart () ; 

) //  close  method 
} //  close  inner  class 


Now  rfcop  whatever  is  iwrve*tW 

a*d  reWld  i>»«  se<\ue*t«  wirA  W *** 

ftate  of  the  eKetkbo«*  in  W Arva'yList- 


has  a huge  limitation!  When  you  hit  the  "serialized  button.  It 
serializes  automatically,  to  a file  named "Checkbox.ser* (which  gets  created  If  it 
doesn't  exist).  But  each  time  you  save, you  overwrite  the  previously-saved  file. 

Improve  the  save  and  restore  feature,  by  Incorporating  a JFIIeChooser  so  that 
you  can  name  and  save  as  many  different  patterns  as  you  like,  and  load/restore 
from  any  of  your  previously-saved  pattern  files. 
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Can  they  be  saved? 

Which  of  these  do  you  think  are,  or  should  be, 
serializable?  If  not,  why  not?  Not  meaningful? 
Security  risk?  Only  works  for  the  current 
execution  of  the  JVM?  Make  your  best  guess, 
without  looking  it  up  in  the  API. 


Object  type 

Serializable? 

Object 

Ves  / No 

String 

Yes  / No 

File 

Yes  / No 

Date 

Yes  / No 

OutputStream 

Yes  / No 

JFrame 

Yes  / No 

Integer 

Yes  / No 

System 

Yes  / No 

If  not,  why  not? 


Whars  Legal? 

Dircle  the  code  fragments 
hat  would  compile  (assuming 
they’re  within  a legal  class). 


KEEP 

RIGHT 


FileReader  fll  eReader  = new  FileReader  ()  ; 

BufferedReader  reader  = new  BufferedReader (fileReader) ; 


FileOutputStreaa  f = new  FileOutputStream (new  File  {" Foe.  ser") ) ; 
ObjectOutputStream  os  - new  ObjectOutputStream(f ) ; 


BufferedReader  reader  = new  BufferedReader (new  FileReader (file) ) ; 
String  line  = null; 

while  ((line  ■ reader. readLine () ) ! = null)  ( 
makeCard(line) ; 

) 


ObjectlnputStrean  is  = new  Objecting  tStreaa  (new  FUeOutputStreamrGame.ser")) ; 
GameCbaracter  onaAgain  = (GameChaiacter)  is.readQbject() ; 
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exercise:  True  or  False 


This  chapter  explored  the  wonerful  world  of 
Java  I/O.  Your  Job  is  to  decide  whether  each 
of  the  following  l/O-related  statements  is 
true  or  false. 

or  Fatsf  ^ 


1.  Serialization  is  appropriate  when  saving  data  for  non-Java  programs  to  use. 

2.  Object  state  can  be  saved  only  by  using  serialization. 

3.  ObjectOutputStream  is  a class  used  to  save  serialized  objects. 

4.  Chain  streams  can  be  used  on  their  own  or  with  connection  streams. 

5.  A single  call  to  writeObject()  can  cause  many  objects  to  be  saved. 

6.  All  classes  are  serializable  by  default. 

7.  The  transient  modifier  allows  you  to  make  instance  variables  serializable. 

8.  If  a superclass  is  not  serializable  then  the  subclass  can’t  be  serializable. 

9.  When  objects  are  deserialized,  they  are  read  back  in  last-in,  first  out  sequence. 

10.  When  an  object  is  deserialized,  its  constructor  does  not  run. 

11.  Both  serialization  and  saving  to  a text  file  can  throw  exceptions. 

12.  BufferedWriters  can  be  chained  to  FileWriters. 

13.  File  objects  represent  files,  but  not  directories. 

14.  You  can’t  force  a buffer  to  send  its  data  before  it’s  full. 

15.  Both  file  readers  and  file  writers  can  be  buffered. 

16.  The  String  split()  method  includes  separators  as  tokens  in  the  result  array. 

17.  Any  change  to  a class  breaks  previously  serialized  objects  of  that  class. 
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Code  Magnets 

This  one's  tricky,®  we  promoted  it  from  an  Exercise  to  full  Puzzle  status. 
Reconstruct  the  code  snippets  to  make  a working  Java  program  that 
produces  the  output  listed  below?  (You  might  not  need  all  of  the  magnets, 
and  you  may  reuse  a magnet  more  than  once,) 


i % EJf!  WhJMr  Help  Torturt 


java  Dun  geo  riles  t 


class  DungeonGame 


implements  Serializable  { 


ObjectlnputStream  ois  - new 

ObjectlnputStream(fis) ; 


int  getx ( ) { 
return  x; 


System. out » print In (d. getx ( )+d.getY( )+d.getZ( ) ) ; 


FilelnputStream  fis  = new  kublic  int  x = 3; 
FileInputStream{"dg.ser" ) ; Iransient  long  y - 4; 

private  short  z - 5; 


d = (DungeonGame)  ois . readOb ject < ) 7 


1 


Ob jectOutputStream  oos  = new 
0bject0utputStream(fo8) ; 


oos 


. wr iteOb ject ( d ) ; 


r^uT^atic  void  main  (String!  ] args)  { 

DungeonGame  d ■ new  DungeonGame ( 
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exercise  solutions 


§r^ 

r^eTcise  Solutions 


1.  Serialization  is  appropriate  when  saving  data  for  non-Java  programs  to  use.  False 

2.  Object  state  can  be  saved  only  by  using  serialization.  False 

3.  ObjectOutputStream  is  a class  used  to  save  serialized  objects.  True 

4.  Chain  streams  can  be  usedon  their  own  or  with  connection  streams.  False 

5.  A single  call  to  writeObject()  can  cause  many  objects  to  be  saved.  True 

6.  All  classes  are  serializable  by  default.  False 

7.  The  transient  modifier  allows  you  to  make  instance  variables  serializable.  False 

8.  If  a superclass  is  not  serializable  then  the  subclass  can’t  be  serializable.  False 

9.  When  objects  are  deserialized  they  are  read  back  in  last-in,  first  out  sequence.  False 

10.  When  an  object  is  deserialized,  its  constructor  does  not  run.  True 

11.  Both  serialization  and  saving  to  a text  file  can  throw  exceptions.  True 

12.  BufferedWriters  can  be  chained  to  FileWriters.  True 

13.  File  objects  represent  files,  but  not  directories.  False 

14.  You  can’t  force  a buffer  to  send  its  data  before  it’s  full.  False 

15.  Both  file  readers  and  file  writers  can  optionally  be  buffered.  True 

16.  The  String  split()  method  includes  separators  as  tokens  in  the  result  array.  False 

1 7.  Any  change  to  a class  breaks  previously  serialized  objects  of  that  class.  Folse 
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import  java.io-*; 

class  DungeonGame  implements  Serializable  { 
public  int  x = 3; 
transient  long  y = 4; 
private  short  z = 5; 
int  getx(>  { 
return  x; 

> 

long  getY( ) { 
return  y; 

} 

short  getZ ( ) ( 
return  2; 


> 

> 


j Ht  W1  ftitm  Hefp  Escape 


¥ java  DungeonTest 
12 
8 


class  DungeonTest  { 

public  static  void  main< String  []  args)  { 

DungeonGame  d = new  DungeonGame{ ) ; 

System- out . pr intin (d . getX( ) + d*getY{)  + d.getZ()); 
try  { 

FileOutputStream  fos  = new  FileOutputStream(  "dg.  ser"  ) ; 
ObjectOutputStream  00s  = new  ObjectOutputStream(fos) ; 
00s -writeObject (d) ; 

00s -close ( ) ; 

FilelnputStream  fis  - new  FilelnputStreamf "dg . ser" ) ; 
ObjectlnputStream  ois  = new  Ob jectInputStream(fis ) ; 
d = (DungeonGame)  ois.readObject( ) ; 
ois  . close ( ) ; 

> catch  (Exception  e)  { 
e.printStac)cTrace{  ) ; 

> 

System. out . println (d. getX< ) + d-getY()  + d.getZ()); 

> 

> 


you  are  here  ► 469 


1 5 networking  and  threads 


Make  a Connection 


Connect  with  the  outside  world.  Your  Java  program  can  reach  out  and  touch  a 
program  on  another  machine,  it's  easy.  All  the  low-level  networking  details  are  taken  care  of  by 
classes  in  the  java.net  library.  One  of  Java’s  big  benefits  is  that  sending  and  receiving  data  over 
a network  Is  just  I/O  with  a slightly  different  connection  stream  at  the  end  of  the  chain.  If  you've 
got  a BufferedReader,  you  can  read.  And  the  Bufferedfteader  could  care  less  if  the  data  came 
out  of  a file  or  flew  down  an  ethernet  cable.  In  this  chapter  we'll  connect  to  the  outside  world 
with  sockets.  We'll  make  c//enf  sockets.  We'll  make  server  sockets.  We'll  make  c//enfs  and  servers. 
And  we'll  make  them  talk  to  each  other.  Before  the  chapter's  done,  you'll  have  a fully-functional, 
multithreaded  chat  client.  Did  we  just  say  multithreaded!  Yes,  now  you  will  learn  the  secret  of 
how  to  talk  to  Bob  while  simultaneously  listening  to  Su2y. 
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t box  chat 

,aHime  Beat  *>x  Chat 


60© 


Cyber  BeatBox 


Bass  Drum 
Dosed  Hi- Hat  { 

Open  Hi-Hat  OOQQQQ DO QQ Q0QOQQ 
Acoustic  Snare  Q Q Q Q QQ  Q Q Q □ O OQ  O QQ 
Crash  Cymbal  GQQOQOQQQQQQQQQQ 
Hand  Gap  Q Q Q Q □ Q Q Q □ OQQ  OQ  QQ 
High  Tom  □□□0000000 QOOO QQ 
Hi  Bongo  QQ  Q OdaQOGOOQfiMSa 
Maracas 

whistle  □□QQQQOQQQQQOQQQ 
Low  Conga  QCQQQCSQ O 80 8 80 QD 
Cowbell  □□QQOQQOQDQQQQQQ 
vibrasiap  QQ  QQQQ  QQQOQOQQQQ 
Low-mid  Tom  QQQQ0QQ0OQQCQQQQ 
HighAgogo  □□Q.DQQQQQQQQGQQQ 
Open  Hi  < 


( Start 

CS3 


f sendH  |jt 

! try  this  one...  It’s  better  for 
sequenced 


! skyter4:  fast  and  funky,  good  for 
i sequence  12 

evster2:  like  skyter2,  but  more 
Oakenfoldhh 

akytefS;  you  WISH!  Too  perky 


mme  you  and  your  team 

»orVing  on  . ^ ^ o£*^e. 

ire  doing  the sound  d Ae  Beat  Box,  your 
Using  a ‘ chat*  version  o pattern  along  ^ 

your  Ch.t  *£jt  gel  w mi  <h.  ■>**  -g-ffg 

gets  it  So  you  don  t j"  8 w ,oad  and  Ta 

participants  mes  g - V dicking  the 
play  a ^eat  ^^^oming  messages  area, 
message  m th  w leam  what  it 

In  this  chapter  we  r g 6^  ^ We're 
takes  to  make  a about  making  a 

even  gomg  to  learn  Beat  Box  Chat 

** .rr  T2 Sen,  but  in  this  chapter  yo 


messages. 


You  u*  Have  iomylftely 
auikmvtit, 

Conversations-  Every 
ii  SCT^t  ’to  al 
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Chat  Program  Overview 

The  Client  has  to  "know 
about  the  Server. 

The  Server  has  to  know 
about  ALL  the  Clients. 


How  it  Works: 

Q Client  connects  to  the  server 


O The  server  makes  a 

connection  and  adds  the  client 
to  the  list  of  participants 

O Another  client  connects 


^ Client  A sends  a message  to 
the  chat  service 


The  server  distributes  the 
message  to  ALL  participants 
(including  the  original  sender) 


Client  C 


Client  B 


Server 


Client  A 


S_  Sorter,  fd  like  to  donneet 
to  the  tha t iOrviee 

Client  A 


Client  A Server 


Server 


Server,  Td  like  to 
to  the  that  service 
4 OK,  you  Ye  in- 

Client  B 


Server 


Server 


'Who  took  the  lava 
■fror*  d&rm  rocw?^ 

Client  A 
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socket  connections 


Connecting,  Sending,  and  Receiving 

The  three  things  we  have  to  learn  to  get  the  client  working  are  : 

1)  How  to  establish  the  initial  connection  between  the  client  and  server 

2)  How  to  send  messages  to  the  server 

3)  How  to  receive  messages  from  the  server 

There’s  a lot  of  low-level  stuff  that  has  to  happen  for  these  things  to  work.  But  we’re 
lucky,  because  the  Java  API  networking  package  (java.net)  makes  it  a piece  of  cake 
for  programmers.  You’ll  see  a lot  more  GUI  code  than  networking  and  I/O  code. 

And  that's  not  all. 

Lurking  within  the  simple  chat  client  is  a problem  we  haven’t  faced  so  far  in  this 
book:  doing  two  things  at  the  same  time.  Establishing  a connection  is  a one-time 
operation  (that  either  works  or  fails).  But  after  that,  a chat  participant  wants  to 
send  outgoing  messages  and  simultaneously  receive  incoming  messages  from  the  other 
participants  (via  the  server).  Hmmmm...  that  ones  going  to  take  a little  thought,  but 
we’ll  get  there  in  just  a few  pages. 


O Connect 


Client  connects  to  the  server  by 
establishing  a Socket  connection. 


Client  A 


/Hake  a socket  conation  to 
at  port  <5000 


Server 


Q Send 

Client  sends  a message  to  the  server 


vrrterprin'tlnfaMettay) 


Client  A 


Server 


O Receive 

Client  gets  a message  from  the  server 


Client  A 


String  s - reader  .readLireO 


Server 
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Make  a network  Socket  connection 


To  connect  to  another  machine,  we  need  a Socket  connection. 
A Socket  ( java.net.Socket  class)  is  an  object  that  represents 
a network  connection  between  two  machines.  What’s  a 
connection?  A relationship  between  two  machines,  where  two 
pieces  of  software  know  about  each  other.  Most  importantly, 
those  two  pieces  of  software  know  how  to  communicate  with 
each  other  In  other  words,  how  to  send  bits  to  each  other. 

We  don't  care  about  the  low-level  details,  thankfully,  because 
they’re  handled  at  a much  lower  place  in  the  ’networking 
stack’.  If  you  don’t  know  what  the  ‘networking  stack’  is,  don’t 
worry  about  it  It’s  just  a way  of  looking  at  the  layers  that 
information  (bits)  must  travel  through  to  get  from  a Java 
program  running  in  a JVM  on  some  OS,  to  physical  hardware 
(ethemet  cables,  for  example),  and  back  again  on  some  other 
machine.  Somebody  has  to  take  care  of  all  the  dirty  details. 

But  not  you.  That  somebody  is  a combination  of  OS-specific 
software  and  the  Java  networking  API.  The  part  that  you  have 
to  worry  about  is  high-level — make  that  very  high-level — and 
shockingly  simple.  Ready? 


To  make  a Socket 
connection,  you  need 
to  know  two  things 
about  the  server  who 
it  is,  and  which  port 
it’s  running  on. 

In  other  words, 

IP  address  and  TCP 
port  number. 


TCP 


Socket  chatSocket  - new  Socket ("196 . 164 . 1 . 103" , 5000); 


Client  Server 


A Socket  connection  means  the  two  machines  have 
information  about  each  other,  including  network 
location  (IP  address)  and  TCP  port. 
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well-known  ports 


A TCP  port  is  just  a number. 

A 1 6-bit  number  that  identifies 
a specific  program  on  the  server 


Your  internet  web  (HTTP)  server  runs  on  port  80.  That’s  a 
standard.  If  you’ve  got  a Telnet  server,  its  running  on  port 
23.  FTP?  20.  POPS  mail  server?  110.  SMTP?  25-  The  Time 
server  sits  at  37.  Think  of  port  numbers  as  unique  identifiers. 
They  represent  a logical  connection  to  a particular  piece  of 
software  running  on  the  server.  That's  it.  You  can’t  spin  your 
hardware  box  around  and  find  a TCP  port  For  one  thing, 
you  have  65536  of  them  on  a server  (0  - 65535).  So  they 
obviously  don't  represent  a place  to  plug  in  physical  devices. 
They’re  just  a number  representing  an  application* 

Without  port  numbers,  the  server  would  have  no  way  of 
knowing  which  application  a client  wanted  to  connect  to. 
And  since  each  application  might  have  its  own  unique 
protocol,  think  of  the  trouble  you’d  have  without  these 
identifiers*  What  if  your  web  browser,  for  example,  landed 
at  the  POP3  mail  server  instead  of  the  HTTP  server?  The 
mail  server  won’t  know  how  to  parse  an  HTTP  request!  And 
even  if  it  did,  the  POPS  server  doesn’t  know  anything  about 
servicing  the  HTTP  request 

When  you  write  a server  program,  you’ll  include  code  that 
tells  the  program  which  port  number  you  want  it  to  run  on 
(you’ll  see  how  to  do  this  in  Java  a litde  later  in  this  chapter). 
In  the  Chat  program  we’re  writing  in  this  chapter,  we  picked 
5000.  Just  because  we  wanted  to.  And  because  it  met  the 
criteria  that  it  be  a number  between  1024  and  65535.  Why 
1024?  Because  0 through  1023  are  reserved  for  the  well- 
known  services  like  the  ones  we  just  talked  about- 

And  if  you're  writing  services  (server  programs)  to  run  on 
a company  network,  you  should  check  with  the  sys-admins 
to  find  out  which  ports  are  already  taken.  Your  sys-admins 
might  tell  you,  for  example,  that  you  can’t  use  any  port 
number  below,  say,  3000.  In  any  case,  if  you  value  your  limbs, 
you  won’t  assign  port  numbers  with  abandon.  Unless  it’s 
your  home  network.  In  which  case  you  just  have  to  check  with 
your  kids. 


Well-known  TCP  port  numbers 
for  common  server  Applications 


https  pcpi 


T elftet  <yv\T? 


A server  tan  have  up  io  fcGZh 

ereni  server  apps  run*mty 
one  per  por-L 


The  TCP  port 
numbers  from  o to  1023 
are  reserved  for  well- 
known  services.  Don't 
use  them  for  your  own 
server  programs!* 

The  chat  server  we’re 
writing  uses  port 
5000.  We  just  picked  a 
number  between  1024 
and  65535. 
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these,  but  the  sys-admin  where  you 
work  will  probably  kill  you. 
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How  do  you  know  the  port 
number  of  the  server  program  you 
want  to  talk  to? 

A- 

That  depends  on  whetherthe 
program  is  one  of  the  well-known 
services.  If  you're  trying  to  connect 
to  a well-known  service,  like  the  ones 
on  the  opposite  page  (HTTP,  SMTP, 
FTP,  etc.)  you  can  look  these  up  on 
the  Internet  (Google "'Well-Known 
TCP  Port"),  Or  ask  your  friendly 
neighborhood  sys-admin. 

But  if  the  program  isn't  one  of  the 
well-known  services,  you  need  to 
find  out  from  whoever  Is  deploying 
the  service.  Ask  him. Or  her. Typically, 
rf  someone  writes  a network  service 
and  wants  others  to  write  clients  for 
it*  they'll  publish  the  IP  address,  port 
number,  and  protocol  for  the  service. 
For  example,  if  you  want  to  write  a 
client  for  a GO  game  server,  you  can 
visit  one  of  the  GO  server  sites  and 
find  information  about  how  to  write  a 
dient  for  that  particular  server. 


Can  there  ever  be  more  than 
one  program  running  on  a single 
port?  In  other  words,  can  two 
applications  on  the  same  server  have 
the  same  port  number7 

A*  No!  If  you  try  to  bind  a program 
to  a port  that  Is  already  in  use, you'll 
get  a BindException.To  bind  a program 
to  a port  just  means  starting  up  a 
server  application  and  telling  It  to  run 
on  a particular  port.  Again,  you'll  learn 
more  about  this  when  we  get  to  the 
server  part  of  this  chapter. 


IP  address  is  ihe  mall 


the  mail 


number  is  like  naming 
a specific  store,  say, 
*Bobls  CD  Shop" 


IP  address  is 
particular  shopping  mall,  say, 
“Flatirons  Marketplace" 


Brain  Barbell 


OK, you  got  a Socket  connection.Theclient  and  the 
server  know  the  IP  address  and  TCP  port  number  for 
each  other.  Now  what?  How  do  you  communicate 
over  that  connection?  In  other  words,  how  do  you 
move  bits  from  one  to  the  other?  Imagine  the  kinds  of 
messages  your  chat  client  needs  to  send  and  receive. 


, do 

ually  talk  h* 
V otker? 


Client 


Server 
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reading  from  a socket 


To  read  data  from  a Socket,  use  a 
BufferedReader 

To  communicate  over  a Socket  connection,  you  use  streams. 
Regular  old  I/O  streams,  just  like  we  used  in  the  last  chapter.  One 
of  the  coolest  features  in  Java  is  that  most  of  your  I/O  work  won’t 
care  what  your  high-level  chain  stream  is  actually  connected  to.  In 
other  words,  you  can  use  a BufferedReader  just  like  you  did  when 
you  were  writing  to  a file,  the  difference  is  that  the  underlying 
connection  stream  is  connected  to  a Socket  rather  than  a File! 

Make  a Socket  connection  to  the  server 


input  and  output  *hrea»ns 
to  and  ( rot*  tie  Socket 

ConrvCdtioKS  v 


Socket  chatSocket  = new  Socket ("127 . 


0.0.1",  5000) 

^1170.01 


l °*€  this  Code  ic  J ,h 

Moke  on  InputStreamReoder  chained  to  the  Socket's 
low-level  (connection)  input  stream 


InputStre&mReader  stream  = new  Inputs tre&mReader (chatSockat . getlnputstream () > ; 

T'  ,,  . . > 3 l0’*'" 

•the  tka'w  streak-  3 c ^*t-+ne* 


■iendlly. 


o 


Make  a BufferedReader  and  read! 


Cham  tWwed  ^ 

{ le«l  xrtzr*  we  y 


BufferedReader  reader  = new  BufferedReader (stream) ; 
String  message  = reader .readLine () ; 


Oe- 


Client 


buffered  characters 


converted  to  characters 


buffered 

characters 


chained  to 


characters 


chained  to 


bytes  from  server 

«- 


011010011 


BufferedReader 


InputStreamReoder 


Socket's  input  stream 
(we  don't  need  to  know 
the  actual  class) 


source 


Server 
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networking  and  threads 


to  write  data  to  a Socket,  use  a 
PrintWriter 


We  didn’t  use  PrintWriter  in  the  last  chapter,  we  used  BufferedWriter.  We  have 
a choice  here,  but  when  you’re  writing  one  String  at  a dme,  PrintWriter  is  the 
standard  choice.  And  you’ll  recognize  the  two  key  methods  in  PrintWriter, 
print()  and  println()I  Just  like  good  o Y System. out- 

, I LL , ,w  as  it  *as 

T>Jf  u—l  l«  *• 

Make  a Socket  connection  to  the  server  / ^et'  "“e  ™ 


/■ 


Socket  chatSocket  = new  Socket ("127 . 0 . 0 . 1",  5000) 


Make  a PrintWriter  chained  to  the  Socket's  low-level 
(connection)  output  stream 

PrintWriter  writer  = new  PrintWriter  (chatSocket. getOutputStream() ) ; 


f 

******  t 

Srfket*.  Ara*.  ** 


Q Write  (print)  something  r ^ vt 

. m o aijU  a ^ ^ ^ w 

writer .println ("message  to  send");  ^ 

writer, print  ("another  message")  ; ^ ^ rCW 


4 


Client 


choracters  bytes  to  server 


PrintWriter  Socket’s  output 

Stream  (we  don’t  need 
to  know  the  actual  class) 


destwfc"' 


Server 
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The  PailyAdvieeClient 

Before  we  start  building  the  Chat  app, 
let's  start  with  something  a little  smaller 
The  Advice  Guy  is  a server  program  that 
offers  up  practical,  inspirational  tips 
to  get  you  through  those  long  days  of 
coding. 

WeTe  building  a client  for  The  Advice 
Guy  program,  which  pulJs  a message 
from  the  server  each  time  it  connects. 

What  are  you  waiting  for?  Who  knows 
what  opportunities  you've  missed 
without  this  app. 


The  Advice  Guy 

Q Connect 


Client  connects  to  the  server  and  gets  an 
input  stream  from  it 


Client 


Make  a t t© 

^0.1*5.1.10}  at  pert  *2>tZ 

io^itetjetUpvtStrcamO - 


Server 


© Read 

Client  reads  a message  from  the  server 


— reader  readLineO 


Client  A 
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PailyAdvieeClient  code 

This  program  makes  a Socket,  makes  a BufferedReader  (with  the 
help  of  other  streams),  and  reads  a single  line  from  the  server 
application  (whatever  is  running  at  port  4242). 


import  java.io.*; 
import  java.net.*;^ 


,tU»  Socket 


.net 


public  class  DailyAdviceClient  { 

public  void  go()  { 

try  { *___  a \d  M"  5P 


hete 


Socket  s = new  Socket ("127 . 0. 0 . 1" , 4242); 


Inputs treamReader  streamReader  = new  Inputs treamReader (s.getInputStream() ) ; 
BufferedReader  reader  = new  BufferedReader  (streamReader)  ; a 3'*^-fcv*cdRca<lc'r  io 

an  InfutStreamReader  to 

■the  infu-t  stream  the 
Socket* 


String  advice  = reader . readLine () ; 
System. out. prin tin ("Today  you  should: 


+ advice) 


reader. close  ()  ; 4 doses  ALL  the  streams 

} catch ( IOException  ex)  { 
ex. prints tackTrace () ; 


ttl*  ^ea<^-'»e0  is  BxArTi  / 
ikt?***  tv CTL^ 

tl^n  ?Fds>  fcyte?  a F/*-£. 


} 


public  static  void  main (String []  args)  { 

DailyAdviceClient  client  = new  DailyAdviceClient ( ) ; 
client. go () ; 

} 
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pwi  yvui  IU1I 

Tcac-t  \if\i  \r  rrackr 


Test  your  memory  of  the  streams/classes  for  reading  and  writing  from  a 
Socket.Try  not  to  look  at  the  opposite  pagel 


To  read  text  from  a Socket: 


Client 


*v>i</ draw  in  ike  4 ha  in  of  streams  ike  dieni 
we*  io  tread  from  ike  server 


sour^ 


Server 


To  send  text  to  a Socket 


Client 


wrrte/draw  in  ihe  4hain  of  streams  ike  dieni 
use*  io  send  someihinj  io  ike  server 


^“■fciAaiioh 


Server 


I — fc^rpen  your  pencil  — 

Fill  In  the  blanks: 


What  two  pieces  of  information  does  the  client  need  in  order  to  make  a 
Socket  connection  with  a server? 


Which  TCP  port  numbers  are  reserved  for'well-known  services' like  HTTP  and  FTP? 


TRUE  or  FALSE:  The  range  of  valid  TCP  port  numbers  can  be  represented 
by  a short  primitive? 
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Writing  a simple  server 

So  what's  it  take  to  write  a server  application?  Just  a 
couple  of  Sockets.  Yes,  a couple  as  in  two,  A ServerSocket, 
which  waits  for  client  requests  (when  a client  makes  a 
newSocket())  and  a plain  old  Socket  socket  to  use  for 
communication  with  the  client. 


How  it  Works: 

Q Server  application  makes  a ServerSocket,  on  a specific  port 

ServerSocket  serverSock  = new  Server Socket (4242) ; 

This  starts  the  server  application  listening 
for  client  requests  coming  in  for  port  4242. 


o 


Client  makes  a Socket  connection  to  the  server  application 

Socket  sock  = new  Socket ("190 . 165 . 1 . 103" , 4242); 


Client  knows  the  IP  address  and  port  number 
(published  or  given  to  him  by  whomever 
configures  the  server  app  to  be  on  that  port) 


o 


Server  makes  a new  Socket  to  communicate  with  this  client 


Socket  sock  = aerverSock . accept <) ; 

The  acceptO  method  blocks  (just  sits  there)  while 
it's  waiting  for  a client  Socket  connection.  When  a 
client  finally  tries  to  connect,  the  method  returns 
a plain  old  Socket  (on  a different  port)  that  knows 
how  to  communicate  with  the  client  (i.e.,  knows  the 
cfienfs  IP  address  and  port  number).  The  Socket  is  on 
a different  port  than  the  ServerSocket,  so  that  the 
ServerSocket  can  go  back  to  waiting  for  other  clients. 


, .a  Ua^ 
tV.e*0 

£<*■  ^ * 
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PailyAdviceServer  code 

This  program  makes  a ServerSocket  and  waits  for  client  requests.  When  it  gets 
a client  request  (i.e.  client  said  new  SocketQ  for  this  application),  the  server 
makes  a new  Socket  connection  to  that  client.  The  server  makes  a PrintWriter 
(using  the  Socket’s  output  stream)  and  sends  a message  to  the  client. 


import  java . io . * ; 
import  java.net.*; 

public  class  DailyAdviceServer  { 


String []  adviceList  = {"Take  smaller  bites",  "Go  for  the  tight  jeans.  No  they  do  NOT 
make  you  look  fat.",  "One  word:  inappropriate",  "Just  for  today,  be  honest.  Tell  your 
boss  what  you  *really*  think",  "You  might  want  to  rethink  that  haircut."} ; 


public  void  go()  { 
try  { 

ServerSocket  serverSock  = new  ServerSocket (4242) 
while (true)  { 


applicate  '|«W  {Jhti  SeIv*r 

P *4  fZfZ  on  +Z  ,e*L 
Code  is  >-unninS  on  ™ ***”*  ™is 


Socket  sock  = serverSock . accept ( ) ; 


tke  addcft  mrtkod  blodks  (just  sits  ihev-e)  until  a 
request  domes  m,  and  then  tKe  method  returns  a 
Sodket  (on  some  anonymous  port)  (or  dommunidatin^ 
with  the  dlient 


PrintWriter  writer  = new  PrintWriter (sock. getOutputStream ( ) ) ; 
String  advice  = getAdvice ( ) ; *V 

writer. println (advice) ; 
writer. close () ; 

System. out. println (advice) ; 


we  me  done  with  this  dient  * be<Uustf 


} catch (IOException  ex)  { 
ex.printStackTrace () ; 

} 

} //  close  go 


private  String  getAdvice ()  { 

int  random  = (int)  (Math . random ( ) * adviceList . length) ; 
return  adviceList [random] ; 

) 


public  static  void  main (String []  args)  { 

DailyAdviceServer  server  = new  DailyAdviceServer {) ; 
server . go ( ) ; 

} 

} 
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Brain  Barbell 


How  does  the  server  know  how  to 
communicate  with  the  client? 

The  client  knows  the  IP  address  and  port 
number  of  the  server,  but  how  is  the  server 
able  to  make  a Socket  connection  with  the 
client  (and  make  input  and  output  streams)? 

Think  about  how  / when  / where  the  server 
gets  knowledge  about  the  client. 


C^nfl^t^uestiPTis 


Q/  The  advice  server  code  on  the  opposite 
page  has  a VERY  serious  limitation— It  looks 
like  it  can  handle  only  one  client  at  a timel 


A* 


L- Yes,  that's  right.  It  can't  accept  a request 
from  a client  until  It  has  finished  with  the 
current  client  and  started  the  next  Iteration  of 
the  infinite  loop  (where  it  sits  at  the  acceptfl 
call  until  a request  comes  in,  at  which  time  It 
makes  a Socket  with  the  new  client  and  Starts 
the  process  over  again). 


% Let  me  rephrase  the  problem:  how  can 
you  make  a server  that  can  handle  multiple 
clients  concurrently???  This  would  never 
work  for  a chat  server, for  Instance. 


A: 


*Ah,  that's  simple,  really.  Use  separate 
threads,  and  give  each  new  client  Socket  to  a 
new  thread.  We're  just  about  to  learn  how  to 
do  that! 


BUIIET  POINTS  

■ Client  and  server  applications  communicate  over  a Socket 
connection. 

■ A Socket  represents  a connection  between  two  applications 
which  may  (or  may  not)  be  running  on  two  different  physical 
machines. 

■ A client  must  know  the  IP  address  (or  domain  name)  and 
TCP  port  number  of  the  server  application. 

■ A TCP  port  is  a 16-bit  unsigned  number  assigned  to  a 
specific  server  application.  TCP  port  numbers  allow  different 
clients  to  connect  to  the  same  machine  but  communicate 
with  different  applications  running  on  that  machine. 

■ The  port  numbers  from  0 through  1 023  are  reserved  for 
“well-known  services’  Including  HTTP,  FTP,  SMTP,  etc. 

■ A client  connects  to  a server  by  making  a Server  socket 

Socket  a = new  Socket ("127 . 0 . 0 . 1" , 4200); 

■ Once  connected,  a client  can  get  input  and  output  streams 
from  the  socket.  These  are  low-level  ’connection'  streams. 

sock . gatlnputStream ( ) ; 

■ To  read  text  data  from  the  server,  create  a BufferedReader, 
chained  to  an  InputStreamReader,  which  is  chained  to  the 
input  stream  from  the  Socket. 

■ InputStreamReader  is  a ‘bridge’  stream  that  takes  in 
bytes  and  converts  them  to  text  (character)  data.  It’s  used 
primarily  to  act  as  the  middle  chain  between  the  high-level 
BufferedReader  and  the  low-level  Socket  input  stream. 

• To  write  text  data  to  the  server,  create  a PrintWriter  chained 
directly  to  the  Socket’s  output  stream.  Call  the  print()  or 
println()  methods  to  send  Strings  to  the  server. 

■ Servers  use  a ServerSocket  that  waits  for  client  requests  on 
a particular  port  number. 

■ When  a ServerSocket  gets  a request,  it  ’accepts’  the  request 
by  making  a Socket  connection  with  the  client 
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Writing  a Chat  Client 

We’ll  write  the  Chat  client  application  in  two  stages.  First  we'll 
make  a send-only  version  that  sends  messages  to  the  server  but 
doesn't  get  to  read  any  of  the  messages  from  other  participants 
(an  exciting  and  mysterious  twist  to  the  whole  chat  room 
concept). 

Then  we'll  go  for  the  full  chat  monty  and  make  one  that  both 
sends  and  receives  chat  messages. 


Version  One:  send-only 


Ludicrously  Simple  Chat  Client  ;] 

i f : 

A 


Code  outline 

public  class  8tmpleChatClientA  { 

JTextField  outgoing; 

PrintWriter  writer; 

Socket  sock; 

public  void  go()  { 

//  make  gui  and  register  a listener  with  the  send  button 
//  call  the  aetUpNetworkingO  method 

) 

private  void  aetUpNetworking ()  { 

//  make  a Socket,  then  make  a PrintWriter 

//  assign  the  PrintWriter  to  writer  instance  variable 

) 

public  class  SandButtonListener  implements  ActionListaner  { 
public  void  actionPerformed(Act±onEvent  ev)  { 

II  get  the  text  from  the  text  field  and 

II  send  it  to  the  server  using  the  writer  (a  PrintWriter) 

) 

} //  close  SandButtonListener  inner  class 

) //  close  outer  class 
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Import  java.io.*; 
inport  java.net.*; 
import  j avax . swing . * ; 
inport  java.awt.*; 
inport  java , awt. event. * ; 


public  class  SimpleChatClientA  { 

JTextField  outgoing; 
PrintWriter  writer ; 

Socket  sock; 


public  void  go()  { 

JFrame  frame  - new  JFrama ("Ludicrously  Simple  Chat  Client") 
JPanel  mainPanel  = new  JPanel () ; 
outgoing  - new  JTextField (20) ; 

JButton  sendButton  = new  JButton  ("Sand")  ; 
sendButton . addActionListener (new  SendButtonLis toner ( ) ) 
mainPanel. add (outgoing) ; 
mainPanel . add (sendButton) ; 

frame . getCon tentPane ( ) . add (BorderLayout . CENTER , mainPanel ) 
setOpNetworkingO  ; 
frame . setSize (400 , 500) ; 
frame . setVi sible (true) ; 

) //  close  go  *eVe 

K u*  itsi  tiieni 


Vseve,  3 "i 
*ttworkm$  <* 


0n  *3thihe 


private  void  setUpKetworking ()  { server 

try  ( t 

sock  = new  Socket  ("127 . 0 . 0 . 1" , 5000); 

writer  = new  PrintWriter (sock .getOutputStream() ) 

System. out. println ("networking  established") ; 

} catch (IOExcept ion  ex)  ( 
ex.printStackTrace () ; 

> 

} II  close  setllpNetworking 


TVn  ii 

a*d  tke  (lts  “l’e' i 

d'uflaywj  w ^ 


public  class  SendButtonLis tener  implements  ActionListener  ( 
public  void  actionPer formed (ActionEvent  ev)  { 


try  { 

writer . println (outgoing . getText ( ) 
writer  .flush  ()  ; 

) catch (Exception  ex)  { 
ex.printStackTraceO  ; 

) 

outgoing, setText ("")  ; 

outgoing, requestFocus ()  ; 

} 

> //  close  SendButtonLis tener  inner  class 

publia  static  void  main (String f]  args)  { 
i lew  SimpleChatClientA  ( ) . go()  ; 

} 

} II  close  outer  class 


; w e di’tuatly  do  'the  wvi'tmg- 

Remember,  ibc  wri-ttfr  is  ihdmcd  to 
tbe  input  rfcre^i*  -from  Sodkctj  *o 
w t do  a PrintlnO,  it  $oa 
over  the  network  to  tbe  server/ 


If  you  want  to  try  this  now,  type  In 
tho  Ready-bake  chat  server  code 
listed  at  the  end  of  this  chapter . 
First,  start  the  server  In  one  terminal. 
Next,  use  another  terminal  to  start 
this  client. 
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The  Stwev  A meu^e  ^ j|| 
6lie»t  pairUipa„U  a*  soon  as  tie 
message  is  Reived  by  the  serve*-. 
When^a  dlient  sends  a message,  it 
doesn't  appear  in  the  incoming 
message  display  area  until  the 
server  se^ds  it  to  cvcvy<^,c 


Big  Question:  HOW  do  you  get  messages  from  the  server? 

Should  be  easy;  when  you  set  up  the  networking  coake  an  input  stream  as  well 
(probably  a BufferedReader).  Then  read  messages  using  readLine(). 


Bigger  Question:  WHEN  do  you  get  messages  from  the  server? 

Think  about  that.  What  are  the  options? 


$ Option  One:  Poll  the  server  every  20  seconds 

Pros:  Well,  it’s  do-able 

Cons:  How  does  the  server  know  what  you’ve  seen  and  what  you  haven’t?  The  server 
would  have  to  store  the  messages,  rather  than  just  doing  a distribute-and-forget  each  time 
it  gets  one.  And  why  20  seconds?  A delay  like  this  affects  usability,  but  as  you  reduce  the 
delay,  you  risk  hitting  your  server  needlessly.  Inefficient. 

^ Option  Two:  Read  something  In  from  the  server  each  time  the  user 
sends  a message. 

Pros:  Do-able,  very  easy 

Cons:  Stupid,  Why  choose  such  an  arbitrary  time  to  check  for  messages?  What  if  a user  is 
a lurker  and  doesn’t  send  anything? 


Option  Three:  Read  messages  as  soon  as  they’re  sent  from  the  server 

Pros:  Most  efficient,  best  usability 

Cons:  How  do  you  do  you  do  two  things  at  the  same  time?  Where  would  you  put  this  code? 
You'd  need  a loop  somewhere  that  was  always  waiting  to  read  from  the  server.  But  where 
would  that  go?  Once  you  launch  the  GUI,  nothing  happens  until  an  event  is  fired  by  a GUI 
component 
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In  Java  you  really  CAN 
waft  and  chew  gum  a t 
the  same  time. 


Multithreading  in  Java 

Java  has  multiple  threading  built  right 
into  the  fabric  of  the  language.  And  it’s  a 
snap  to  make  a new  thread  of  execution: 


You  know  by  now  that  we’re 
going  with  option  three. 

We  want  something  to  run  continuously* 
checking  for  messages  from  the  server, 
but  without  interrupting  the  user's  ability  to 
interact  with  the  GUI!  So  while  the  user  is 
happily  typing  new  messages  or  scrolling 
through  the  incoming  messages,  we 
want  something  behind  the  scenes  to  keep 
reading  in  new  input  from  the  server. 

That  means  we  finally  need  a new  thread. 
A new,  separate  stack 

We  want  everything  we  did  in  the  Send- 
Only  version  (version  one)  to  work  the 
same  way,  while  a new  process  runs  along 
side  that  reads  information  from  the 
server  and  displays  it  in  the  incoming  text 
area. 

Well,  not  quite.  Unless  you  have  multiple 
processors  on  your  computer,  each  new 
Java  thread  is  not  actually  a separate 
process  running  on  the  OS.  But  it  almost 
feels  as  though  it  is. 


Thread  t = new  Thread  ()  ; 
t. start () ; 

That’s  it.  By  creating  a new  Thread  object, 
you’ve  launched  a separate  thread  of 
execution,  with  its  very  own  call  stack. 

Except  for  one  problem. 

That  thread  doesn't  actually  do  anything, 
so  the  thread  “dies*  virtually  the  instant 
it’s  bom.  When  a thread  dies,  its  new 
stack  disappears  again.  End  of  story. 

So  we’re  missing  one  key  component — 
the  thread’s  job.  In  other  words,  we  need 
the  code  that  you  want  to  have  run  by  a 
separate  thread. 

Multiple  threading  in  Java  means  we 
have  to  look  at  both  the  thread  and  the  job 
that's  run  by  the  thread.  And  we’ll  also 
have  to  look  at  the  Thread  class  in  the 
java.lang  package.  (Remember,  java.lang 
is  the  package  you  get  imported  for 
free,  implicitly,  and  it’s  where  the  classes 
most  fundamental  to  the  language  live, 
including  Siring  and  System.) 
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Java  has  multiple  threads  but  only 
one  Thread  elass 


We  can  talk  about  tkreadwixh  a lower-case  ‘t’  and  Thread 
with  a capital  ‘T\  When  you  see  thread  we're  talking 
about  a separate  thread  of  execution.  In  other  words, 
a separate  call  stack.  When  you  see  Thread,  think  of 
the  Java  naming  convention.  What,  injava,  starts  with  a 
capital  letter?  Classes  and  interfaces.  In  this  case,  Thread 
is  a class  in  the  java. )ang  package.  A Thread  object 
represents  a thread  of  execution;  you'll  create  an  instance  of 
class  Thread  each  time  you  want  to  start  up  a new  thread 
of  execution. 


A thread  is  a separate 
‘thread  of  execution . 
In  other  words,  a 
separate  call  stack. 

A Thread  is  a Java 
class  that  represents 
a thread. 

To  make  a thread, 
make  a Thread. 


thread 


Jhread 


main  thread  another  thread 

started  by  the  code 


Thread 

void  joinO 
void  startQ 

sladc  void  sleepQ 


java.iang.Thread 

class 


A thread  (lower-case  V)  is  a separate  thread  of  execution. 
That  means  a separate  call  stack.  Every  Java  application 
starts  up  a main  thread — the  thread  that  puts  the 
main()  method  on  the  bottom  of  the  stack.  The  JVM 
is  responsible  for  starting  the  main  thread  (and  oilier 
threads,  as  it  chooses,  including  the  garbage  collection 
thread).  As  a programmer,  you  can  write  code  to  start 
other  threads  of  your  own. 


Thread  (capital  Tf)  is  a class  that 
represents  a thread  of  execution. 

It  has  methods  for  starting  a 
thread,  joining  one  thread  with 
another,  and  putting  a thread  to 
sleep.  (It  has  more  methods;  these 
are  just  the  crucial  ones  we  need 
to  use  now). 
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What  does  it  wean  to  have  wore  than 
one  call  stack? 


With  more  than  one  call  stack,  you  get  the  appearance  of  having 
multiple  things  happen  at  the  same  time.  In  reality,  only  a true 
multiprocessor  system  can  actually  do  more  than  one  thing  at  a 
time,  but  with  Java  threads*  it  can  appear  that  you’re  doing  several 
things  simultaneously.  In  other  words*  execution  can  move  back 
and  forth  between  stack s so  rapidly  that  you  feel  as  though  all  stacks 
are  executing  at  the  same  time.  Remember*  Java  is  just  a process 
running  on  your  underlying  OS.  So  first,  Java  itself  has  to  be  'the 
currently  executing  process’  on  the  OS.  But  oncejava  gets  its 
turn  to  execute,  exactly  undoes  the  JVM  run?  Which  bytecodes 
execute?  Whatever  is  on  the  top  of  the  currently-running  stack! 

And  in  100  milliseconds,  the  currendy  executing  code  might  switch 
to  a different  method  on  a different  stack. 


One  of  the  things  a thread  must  do  is  keep  track  of  which  statement 
(of  which  method)  is  currendy  executing  on  the  thread’s  stack. 


It  might  took  something  like  this: 

The  JVM  calls  the  ma[n()  method, 

public  static  void  main  (String  [1  arga) 

) 


ike  active  -tkvead 


main  thread 


mam()  starts  a new  thread.  The  main 
thread  is  temporarily  frozen  while  the  new 
thread  starts  running. 


Runnable  r = new  MyThxeadJob  ( ) ; x. 
Thread  t = new  Thread  (r)  ; W||  |M^V  , 

t.  a tart  ()  ; bii  ih 

Dog  d = new  Dog  ( ) ; a moment..  J 


main  thread 


a t>ew  tbead  s-fcarb 
and  becomes  be  active 
bread  ^ 


user  thread  A 


The  JVM  switches  between  the  new 
thread  (user  thread  A)  and  the  original 
main  thread,  until  both  threads  complete. 


main  thread 


user  thread  A 
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How  to  launch  a new  thread: 


O Make  a Runnable  object  (the  thread’s  job) 

Runnable  threadJob  = new  MyRunnable ( ) ; 

Runnable  is  an  interface  you'll  learn  about  on  the  next  page. 
You'll  write  a class  that  implements  the  Runnable  interface, 
and  that  class  is  where  you'll  define  the  work  that  a thread 
will  perform,  In  other  words,  the  method  that  will  be  run 
from  the  thread's  new  call  stack. 


@ Make  a Thread  object  (the  worker)  and 
give  it  a Runnable  (the  job) 

Thread  myThread  = new  Thread (threadJob) ; 

Pass  the  new  Runnable  object  to  the  Thread  constructor. 
This  tells  the  new  Thread  object  which  method  to  put  on 
the  bottom  of  the  new  stack— the  Runnable's  run()  method. 


Q Start  the  Thread 

myThread . start ( ) ; 

Nothing  happens  until  you  call  the  Thread's 
start()  method.  That's  when  you  go  from 
having  just  a Thread  instance  to  having  a new 
thread  of  execution,  When  the  new  thread 
starts  up,  it  takes  the  Runnable  object's 
run()  method  and  puts  it  on  the  bottom  of 
the  new  thread's  Stack, 


run() 
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Runnable  is  to  a 
Thread  what  a job  is  to 
a worker.  A Runnable 
is  the  job  a thread  is 
supposed  to  run. 

A Runnable  holds  the 
method  -that  goes  on 
■fhe  bottom  of  the  new 
thread’s  Stack-  run(). 


A Thread  object  needs  a job.  Ajob  the  thread  will  run  when  the 
thread  is  started.  That  job  is  actually  the  first  method  that  goes  on 
the  new  thread's  stack,  and  it  must  always  be  a method  that  looks 
like  this: 

public  void  runO  { 

U code  that  will  be  run  by  the  new  thread 

> 


i ritt  At?'***  or^  jr 

*ct>T  lV.  .l^.) 

'jwhett*'  r- 


»*££***** 


How  does  the  thread  know  which  method  to  put  at  the  bottom  of 
the  stack?  Because  Runnable  defines  a contract.  Because  Runnable 
is  an  interface.  A thread’sjob  can  be  defined  in  any  class  that 
implements  the  Runnable  interface.  The  thread  cares  only  that  you 
pass  the  Thread  constructor  an  object  of  a class  that  implements 
Runnable. 

When  you  pass  a Runnable  to  a Thread  constructor,  you’re  really 
just  giving  the  Thread  a way  to  get  to  a run{)  method.  You're  giving 
the  Thread  its  job  to  do. 
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To  wake  a Job  for  your  thread, 
implement  the  Runnable  interface 


public  class  MyRunnable  implements  Runnable  { 


public  void  run()  ( ; 
go()  ; 

) 

public  void  go()  { 
doMore ( ) ; 


" tamable  has  only  one  method  to 
implement-*  public  Void  runO  (with  »0 

jinS  n:s  “ y*  ?»i  the 

J°R  ^“f1  u suPP«ed  to  nun.  This 
« the  method  that  Joes  at  the  bottom 
°r  the  new  stack- 


public  void  doMore  ()  { 

System,  out.  println  ("top  o'  the  stack"); 

} 


class  ThreadlTaater  { 


public  static  void  main  (String []  ergs 


pass  the  the  thread 

J , Thread  6onstruetor-  the  new 

/ what  method  to  {-^  method  that 

„ . / t+ack.  In  other  words,  the  *■« 


Runnable  threadJob  = new  MyRunnable  ( ) ; sxdi*-  ^ ^ 

Thread  myThread  = new  Thread (threadJob)  ; **VI  ** 


myThread  . start  (); 


System,  out  .prin tin  ("back  in  main") 
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The  three  states  of  a new  thread 


this  is  »v,Bre.  a 

■t®  ^e- 


Thread  t = new  Thread  (r)  ; 


NEW 


start ( ) ; 


waiting  to 
started11 


Thxead  t = new  Thread (r) ; 


A Thread  instance  has  been 
created  but  not  started. 

In  other  words,  there  is  a 
Thread  object , but  no  thread 
of  execution. 


t . start ( ) ; 

When  you  start  the  thread,  it 
moves  into  the  runnable  state. 
This  means  the  thread  is  ready 
to  run  and  just  waiting  for  its 
Big  Chance  to  be  selected  For 
execution.  At  this  point,  there  is 
a new  call  stack  for  this  thread. 


This  is  the  state  all  threads  lust 
afterl  To  be  The  Chosen  One. 
The  Currently  Running  Thread. 
Only  the  JVM  thread  scheduler 
can  make  that  decision.  You 
can  sometimes  influence  that 
decision,  but  you  cannot  force  a 
thread  to  move  from  runnable 
to  running.  In  the  running 
state,  a thread  (and  ONLY  this 
thread)  has  an  active  call  stack, 
and  the  method  on  the  top  of 
the  stack  is  executing. 


But  there’s  more.  Once  the  thread  becomes 
runnable,  it  can  move  back  and  forth  between 
runnable,  running,  and  an  additional  state: 
temporarily  not  runnable  (also  known  as  ‘blocked’). 


you  are  here  ► 495 


thread  states 


Typical  runnable/running  loop 


RUNNABLE 


RUNNING 


Typically,  a thread  moves  back  and 
forth  between  runnable  and  running, 
as  the  JVM  thread  scheduler  selects  a 
thread  to  run  and  then  kicks  it  back 
out  so  another  thread  gets  a chance. 


A thread  can  be  made 
temporarily  not-runnable 


The  thread  scheduler  can  move  a 
running  thread  into  a blocked  state, 
for  a variety  of  reasons.  For  example, 
the  thread  might  be  executing  code 
to  read  from  a Socket  input  stream, 
but  there  isn't  any  data  to  read.  The 
scheduler  will  move  the  thread  out 
of  the  running  state  undl  something 
becomes  available.  Or  the  executing 
code  might  have  told  the  thread  to 
put  itself  to  sleep  (sleepO).  Or  the 
thread  might  be  waiting  because  it 
tried  to  call  a method  on  an  object, 
and  that  object  was  ‘locked1.  In  that 
case,  the  thread  can't  continue  until 
the  object's  lock  is  freed  by  the  thread 
that  has  it. 

All  of  those  conditions  (and  more) 
cause  a thread  to  become  temporarily 
not-runnable. 


RUNNABLE 


RUNNING 


sleeping  wditinA  -for  a^oiher  thread  to  fihish, 
waiting  for  data  to  be  available  oh  the  stream, 

waiting  for  an  objects  lock  ■■ 
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The  Thread  Scheduler 


The  thread  scheduler  makes  all  the  decisions  about 
who  moves  from  runnable  to  running,  and  about  when 
(and  under  what  circumstances)  a thread  leaves  the 
running  state.  The  scheduler  decides  who  runs,  and  for 
how  long,  and  where  the  threads  go  when  the  scheduler 
decides  to  kick  them  out  of  the  currently-running  state. 

You  can't  control  the  scheduler  There  is  no  API  for 
calling  methods  on  the  scheduler.  Most  importantly, 
there  are  no  guarantees  about  scheduling!  (There  are  a 
few  almost-guzrantees,  but  even  those  are  a little  fuzzy.) 

The  bottom  line  is  this:  do  not  base  your  program's 
correctness  on  the  scheduler  working  in  a particular  way! 
The  scheduler  implementations  are  different  for 
different  JVM ’s,  and  even  running  the  same  program 
on  the  same  machine  can  give  you  different  results. 

One  of  the  worst  mistakes  new  Java  programmers 
make  is  to  test  their  multithreaded  program  on  a 
single  machine,  and  assume  the  thread  scheduler  will 
always  work  that  way,  regardless  of  where  the  program 
runs. 

So  what  does  this  mean  for  writeo n c e-run-aunywh ere? 

It  means  that  to  write  platform-independentjava  code, 
your  multi-threaded  program  must  work  no  matter  how 
the  thread  scheduler  behaves.  That  means  that  you  can't 
be  dependent  on,  for  example,  the  scheduler  making 
sure  all  the  threads  take  nice,  perfectly  fair  and  equal 
turns  at  the  running  state.  Although  highly  unlikely 
today,  your  program  might  end  up  running  on  a JVM 
with  a scheduler  that  says,  "OK  thread  five,  you're  up, 
and  as  far  as  I'm  concerned,  you  can  stay  here  until 
you're  done,  when  your  run()  method  completes.” 

The  secret  to  almost  everything  is  sleep.  That's 
right,  sleep.  Putting  a thread  to  sleep,  even  for  a few 
milliseconds,  forces  the  currendy-running  thread  to 
leave  the  running  state,  thus  giving  another  thread  a 
chance  to  run.  The  thread's  sleep()  method  does  come 
with  ow*  guarantee:  a sleeping  thread  will  not  become 
the  currendy-running  thread  before  the  the  length  of 
its  sleep  time  has  expired.  For  example,  if  you  tell  your 
thread  to  sleep  for  two  seconds  (2,000  milliseconds), 
that  thread  can  never  become  the  running  thread  again 
until  sometime  after  the  two  seconds  have  passed. 


Number  four,  you’ve  hod 
enough  time.  Back  to  runnable. 
Number  two,  looks  like  you're  up! 

Oh,  now  it  looks  like  you're  gonna  have 
to  sleep.  Number  five,  come  take  his 
place.  Number  two,  you're  still 
sleeping... 


Tie  thread 
scheduler  makes  all 
the  decisions  about 
who  runs  and  who 
doesn’t.  He  usually 
makes  the  threads  take 
turns,  nicely.  But 
there’s  no  guarantee 
about  that.  0e  might 
let  one  thread  run 
to  its  heart's  content 
while  die  other 
threads  ‘starve’. 
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An  example  of  how  unpredictable  the 
scheduler  can  be... 


Running  this  code  on  one  machine: 


Produced  this  output: 


public  class  MyRunnable  implements  Runnable  { 
public  void  run ( ) { 

go  ()  ; 

} 

public  void  go()  { 
doMore ( > ; 

> 

public  void  doMore ()  { 

System, out .println ("top  o'  the  stack1')  ; 

) 


class  ThreadTes  tDrive  { 


public  static  void  main  (String[]  args)  { 

Runnable  threadiJob  = new  MyRunnable  ()  ; 
Thread  myThread  = new  Thread (threadJob) ; 

myThread . start ( ) ; 


System. out. println ("back  in  main"); 


/ 


tv,e 
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How  did  we  end  up  with  different  results? 


Sometimes  it  runs  like  this: 


malnO  starts  the 
new  thread 


The  scheduler  sends 
the  main  thread  out 
of  running  and  back 
to  runnable,  so  that 
the  new  thread  can 


The  scheduler  lets 
the  new  thread 
run  to  completion, 
printing  out  Top  o‘ 
the  stack" 


main  thread 


new  thread 


run. 


The  new  thread  goes 
away,  because  its  run() 
completed.  The  main 
Ihread  once  again 
becomes  the  running 
thread,  and  prints  "back 
In  main' 


main  thread 


time 


And  sometimes  it  runs  like  this: 


mainf)  starts  the 
new  thread 


The  scheduler  sends 
the  main  thread  out 
of  running  and  back 
to  runnable,  so  that 
the  new  thread  can 
run. 


The  scheduler  lets  the 
new  thread  run  fora 
little  while,  notlong 
enough  for  therunQ 
method  to  complete. 


The  scheduler 
sends  the  new 
thread  back  to 
runnable. 


The  scheduler 
selects  the  main 
thread  to  be  the 
running  thread 
again.  Main  prints 
out  ‘back  In  main"1 


main  thread 


main  thread  new  thread 


time 


The  new  thread  returns 
to  the  running  stale 
and  prints  out  Top  o' 
the  stack'. 


new  thread 
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I've  seen  examples  that  don't  use  a separate 
Runnable  Implementation,  but  Instead  just  make  a 
subclass  of  Thread  and  override  the  Thread's  runQ 
method.  That  way,  you  call  the  Thread's  no-arg 
constructor  when  you  make  the  new  thread; 

Thread  t = newThreadO;  II  no  Runnable 

Yes,  that  Is  another  way  of  making  your  own 
thread,  but  think  about  ft  from  an  OO  perspective. 
What's  the  purpose  of  subclassing?  Remember  that 
we're  talking  about  two  different  things  here— the 
Thread  and  the  thread's  job.  From  an  OO  view,  those 
two  are  very  separate  activities,  and  belong  in  separate 
classes.The  only  time  you  want  to  subclass/extend 
the  Thread  class,  Is  if  you  are  making  a new  and  more 
specific  type  of  Thread.  In  other  words,  if  you  think  of 
the  Thread  as  the  worker,  don't  extend  the  Thread  class 
unless  you  need  more  specific  worker  behaviors.  But  If 
all  you  need  Is  a new  Job  to  be  run  by  a Thread/worker, 
then  implement  Runnable  In  a separate, /ob-specific 
(not  worfcer-speciflc)  class. 

This  is  a design  Issue  and  not  a performance  or 
language  issue.  It's  perfectly  legal  to  subclass  Thread 
and  override  the  run()  method,  but  It's  rarely  a good 
Idea. 


Can  you  reuse  a Thread  object?  Can  you  give  It 
a new  job  to  do  and  then  restart  It  by  calling  startO 
again? 

A. 

*1'  No.  Once  a thread's  run()  method  has  completed, 
the  thread  can  never  be  restarted.  In  fact, at  that 
point  the  thread  moves  into  a state  we  haven't  talked 
about — deadAn  the  dead  state,  the  thread  has 
finished  Its  run()  method  and  can  never  be  restarted. 
The  Thread  object  might  still  be  on  the  heap,  as  a 
living  object  that  you  can  call  other  methods  on  (If 
appropriate),  but  the  Thread  object  has  permanently 
lost  its 'thread  ness'.  In  other  words,  there  Is  no  longera 
separate  call  stack,  and  the  Thread  object  Is  no  longer 
a thread.  It's  just  an  object,  at  that  point,  like  all  other 
objects. 

But,  there  are  design  patterns  for  making  a pool  of 
threads  that  you  can  keep  using  to  perform  different 
jobs.  But  you  don’t  do  It  by  restartlngO  a dead  thread. 


■ A thread  with  a lower-case  T is  a separate  thread  of 
execution  in  Java. 

■ Every  thread  In  Java  has  its  own  call  stack. 

■ A Thread  with  a capital  T is  the  java.Iang.Thread 
cfass.  A Thread  object  represents  a thread  of 
execution. 

■ A Thread  needs  a job  to  do.  A Thread's  job  is  an 
instance  of  something  that  implements  the  Runnable 
interface. 

■ The  Runnable  interface  has  just  a single  method,  run(). 
This  is  the  method  that  goes  on  the  bottom  of  the  new 
call  stack.  In  other  words,  it  is  the  first  method  to  run  In 
the  new  thread. 

■ To  launch  a new  thread,  you  need  a Runnable  to  pass 
to  the  Thread's  constructor. 

■ A thread  Is  in  the  NEW  state  when  you  have 
instantiated  a Thread  object  but  have  not  yet  called 
start(). 

■ When  you  start  a thread  (by  calling  the  Thread  object's 
start()  method),  a new  stack  is  created,  with  the 
Runnable's  runO  method  on  the  bottom  of  the  stack. 
The  thread  is  now  in  the  RUNNABLE  state,  waiting  to 
be  chosen  to  run. 

■ A thread  is  said  to  be  RUNNING  when  the  JVM’s 
thread  scheduler  has  selected  it  to  be  the  currently- 
running  thread.  On  a single-processor  machine,  there 
can  be  only  one  currently-running  thread. 

■ Sometimes  a thread  can  be  moved  from  the  RUNNING 
state  to  a BLOCKED  {temporarily  non-runnable)  state. 
A thread  might  be  blocked  because  it’s  waiting  for  data 
from  a stream,  or  because  it  has  gone  to  sleep,  or 
because  it  is  waiting  for  an  object's  lock. 

■ Thread  scheduling  is  not  guaranteed  to  work  in  any 
particular  way,  so  you  cannot  be  certain  that  threads 
will  take  turns  nicely.  You  can  help  influence  turn-taking 
by  putting  your  threads  to  sleep  periodically. 
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Putting  a thread  to  sleep 


One  of  the  best  ways  to  help  your  threads  take  turns  is 
to  put  them  to  sleep  periodically.  All  you  need  to  do 
is  call  the  static  sleep()  method,  passing  it  the  sleep 
duration,  in  milliseconds. 

For  example: 

Thread, sleep (2000) ; 

will  knock  a thread  out  of  the  running  state,  and 
keep  it  out  of  the  runnable  state  for  two  seconds. 
The  thread  can’t  become  the  running  thread 
again  until  after  at  least  two  seconds  have  passed. 

A bit  unfortunately,  the  sleep  method  throws  an 
InterruptedException,  a checked  exception,  so  all 
calls  to  sleep  must  be  wrapped  in  a try/ catch  (or 
declared).  So  a sleep  call  really  looks  like  this: 

try  ( 

Thread. sleep (2000) ; 

) catch (InterruptedException  ex)  { 
ex. prints tackTrace () ; 

> 


Your  thread  will  probably  never  be  interrupted  from 
sleep;  the  exception  is  in  the  API  to  support  a thread 
communication  mechanism  that  almost  nobody  uses  in 
the  Real  World.  But,  you  still  have  to  obey  die  handle 
or  declare  law,  so  you  need  to  get  used  to  wrapping  your 
sleep()  calls  in  a try/catch. 


Now  you  know  that  your  thread  won't  wake  up  before  [he 
specified  duration,  but  is  it  possible  that  it  will  wake  up 
some  time  after  the  'timer'  has  expired?  Yes  and  no.  It 
doesn’t  matter,  really,  because  when  the  thread  wakes 
up,  it  always  goes  bach  to  the  runnable  state!  The  thread 
won’t  automatically  wake  up  at  the  designated  time  and 
become  the  currently-running  thread.  When  a thread 
wakes  up,  die  thread  is  once  again  at  the  mercy  of 
the  thread  scheduler.  Now,  for  applications  that  don’t 
require  perfect  timing,  and  that  have  only  a few  threads, 
it  might  appear  as  though  the  thread  wakes  up  and 
resumes  running  right  on  schedule  (say,  after  the  2000 
milliseconds).  But  don’t  bet  your  program  on  it. 


Put  your  thread  to  sleep 
if  you  want  to  be  sure 
that  other  threads  get  a 
chance  to  run. 

\tfhen  the  thread  wakes 
up,  it  always  goes  back 
to  die  runnable  state 
and  waits  for  the  thread 
scheduler  to  choose  it 
to  run  again. 
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Using  sleep  to  make  our  program 
more  predictable. 

Remember  our  earlier  example  that  kept  giving  us  different 
results  each  time  we  ran  it?  Look  back  and  study  the  code 
and  the  sample  output  Sometimes  main  had  to  wait  until  the 
new  thread  finished  (and  printed  “top  o'  the  stack”),  while 
other  times  the  new  thread  would  be  sent  back  to  runnable 
before  it  was  finished,  allowing  the  main  thread  to  come  back 
in  and  print  out  “back  in  main”.  How  can  we  fix  that?  Stop 
for  a moment  and  answer  this  question:  “Where  can  you  put 
a sleep  ()  call,  to  make  sure  that  “back  in  main”  always  prints 
before  “top  o'  the  stack”? 

We'll  wait  while  you  work  out  an  answer  (there's  more  than 
one  answer  that  would  work). 

Figure  it  out? 


public  class  My Runnable  implements  Runnable  ( 

public  void  run()  { 
go()  ; 

) 
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public  void  go()  { 


try  { 

Thread. sleep (2000)  ; 

) catch  (InterruptadException  ex)  ( 
•x.prlntSt&ckTraceQ  ; 

) 


doMore  ()  ; 

) 


[ to  leave  the  t 

• viill  "th 

U?*re  * 

U.-uV  in  ■ iA  U*fo»rC  vie 


public  void  doMore ()  ( 

System,  out.  println  ("top  o'  the  stack"); 

} 


class  ThreadTestDrive  ( 

public  static  void  main  (String []  args)  { 
Runnable  the Job  » new  My Runnable ( ) ; 
Thread  t = new  Thread (the Job) ; 
t. start  0 ; 

System. out .println ("back  in  main"); 

) 

> 
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Making  and  starting  two  threads 

Threads  have  names.  You  can  give  your  threads  a name  of 
your  choosing,  or  you  can  accept  their  default  names.  But  the 
cool  thing  about  names  is  that  you  can  use  them  to  tell  which 
thread  is  running.  The  following  example  starts  two  threads. 
Each  thread  has  the  same  job:  run  in  a loop,  printing  the 
currently-running  thread’s  name  with  each  iteration. 


public  class  Run Threads  implements  Runnable  { 

o 

public  static  void  main  (String [J  args)  { . |V\aV&  ^ lNurJru> 

RunThreads  runner  = new  RunThreads ( ) ; 

Thread  alpha  - new  Thread  (runner)  ; 4 t i lL  j 

Thread  beta  = new  Thread  (runner)  ; i (tW 

alpha . setMame ( "Alpha  thread" ) ; ^ 

beta . satNama ("Bata  thread")  ; ***  WC  ''M"'aWe  m a +ew  Pa3«j)- 

alpha. start ()  ; -fc),e 

bata.startO;  <r—  Sta*4  ihe  thwack 

public  void  run  ( ) { . ...  eatVi  timt- 

for  (int  i = 0;  i < 25;  i++)  { rrml  “ 

String  thraadNana  “ Thread . currentThraad ( ) . getName ( ) ; 

System. out. prin tin (threadNama  + " is  running"); 


) 


) 


) 


What  will  happen? 


Part  o(  y*  output  when 

the  loop  itev-ate*  26 
t^es. 


Will  the  threads  take  turns?  Will  you  see  the  thread  names 
alternating?  How  often  will  they  switch?  With  each  iteration? 
After  five  iterations? 

You  already  know  the  answer:  we  don't  know f It’s  up  to  the 
scheduler.  And  on  your  OS,  with  your  particular  JVM,  on 
your  CPU,  you  might  get  very  different  results. 

Running  under  OSX  10.2  (Jaguar),  with  five  or  fewer 
iterations,  the  Alpha  thread  runs  to  completion,  then 
the  Beta  thread  runs  to  completion.  Very  consistent.  Not 
guaranteed,  but  very  consistent. 

But  when  you  up  the  loop  to  25  or  more  iterations,  things 
start  to  wobble.  The  Alpha  thread  might  not  get  to  complete 
all  25  iterations  before  the  scheduler  sends  it  back  to 
runnable  to  let  the  Beta  thread  have  a chance. 
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aren’t  threads  wonderful? 


Um,  yes.  There  IS  a dark  side. 

Threads  can  lead  to  concurrency  'issues' 

Concurrency  issues  lead  to  race  conditions.  Race  conditions 
lead  to  data  corruption.  Data  corruption  leads  to  fear...  you 
know  the  rest. 

It  all  comes  down  to  one  potentially  deadly  scenario:  two  or 
more  threads  have  access  to  a single  object's  data.  In  other 
words,  methods  executing  on  two  different  stacks  are  both 
calling,  say,  getters  or  setters  on  a single  object  on  the  heap. 

It's  a whole  ' 1 eft-hand-doe  $ n’t- know-wh  a t-the-right-h  an  d- 
is-doing’  thing.  Two  threads,  without  a care  in  the  world, 
humming  along  executing  their  methods,  each  thread 
thinking  that  he  is  the  One'True  Thread.  The  only  one 
that  matters.  After  all,  when  a thread  is  not  running,  and  in 
runnable  (or  blocked)  its  essentially  knocked  unconscious. 
When  it  becomes  the  currently-running  thread  again,  it  doesn’t 
know  that  it  ever  stopped. 
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Marriage  in  Trouble. 

Can  this  couple  be  saved? 

Next,  on  a very  special  Dr.Steve  Show 

[Transcript  from  episode  #42] 

Welcome  to  the  Dr.  Steve  show. 


We’ve  got  a story  today  that’s  centered  around  the  top  two  reasons  why 
couples  split  up— finances  and  sleep. 


*Tf! 


Today’s  troubled  pair,  Ryan  and  Monica,  share  abed  and  a 
bank  account.  But  not  for  long  If  we  can’t  find  a solution.  The 
problem?  The  classic  “two  people— one  bank  account”  thing. 

Here’s  how  Monica  described  it  to  me: 


“Ryan  and  I agreed  that  neither  of  us  will  overdraw  the  checking  account. 
So  the  procedure  is,  whoever  wants  to  withdraw  money  must  check  the 
balance  in  the  account  before  making  the  withdrawal.  It  all  seemed  so 
simple.  But  suddenly  we’re  bouncing  checks  and  getting  hit  with  overdraft 
ffees  I 

I thought  it  wasn’t  possible,  I thought  our  procedure  was  safe.  But  then 
this  happened; 


5 ,"  d 

two  peep le,  one 
problem 


Ryan  needed  $50,  so  he  checked  the  balance  in  the  account, 
and  saw  that  it  was  $ 100.  No  problem.  So,  he  plans  to 
withdraw  the  money.  But  first  ha  asleep  i 

And  that’s  where  I come  in,  while  Ryan's  still  asleep,  and 
now  I want  to  withdraw  $100. 1 check  the  balance,  and 
it's  $100  (because  Ryan’s  still  asleep  and  hasn't  yet  made 
his  withdrawal),  so  I think,  no  problem  So  I make  the 
withdrawal,  and  again  no  problem  But  then  Ryan  wakes  up, 
completes  his  withdrawal,  and  we’re  suddenly  overdrawn  I He  didn’t 
even  know  that  he  fell  asleep,  so  he  Just  went  ahead  and  completed  his 
transaction  without  checking  the  balance  again.  You’ve  got  to  help  us  Dr. 
Stevel” 


^ falW 
V tbctks  tV.e  balance 

;akei 

tV  V«t^awl 


Is  there  a solution?  Are  they  doomed?  We  can’t  stop  Ryan  from  falling 
asleep,  but  can  we  make  sure  that  Monica  can’t  get  her  hands  on  the  bank 
account  until  after  he  wakes  up? 

Take  a moment  and  think  about  that  while  we  go  to  a commercial  break. 
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The  Ryan  and  Monica  problem,  in  code 


The  following  example  shows  what  can  happen  when  two 
threads  (Ryan  and  Monica)  share  a single  object  (the  bank 
account). 

The  code  has  two  classes,  BankAccount,  and 
MonicaAndRyanJob.  The  MonicaAndRyanJob  class 
implements  Runnable,  and  represents  the  behavior  that  Ryan 
and  Monica  both  have — checking  the  balance  and  making 
withdrawals.  But  of  course,  each  thread  fells  asleep  in  between 
checking  the  balance  and  actually  making  the  withdrawal. 

The  MonicaAndRyanJob  class  has  an  instance  variable  of  type 
BankAccount.,  that  represents  their  shared  account 

The  code  works  like  this: 


BankAccount 
int  balance 

getBalance() 

withdrawO 


£ Moke  one  instance  of  RyanAndMonicaJob. 


Runnable 


T 


RyanAndMonlcaJob 
BankAccount  account 
run() 

makeWithdrawalQ 


The  RyonAndMonicaJob  class  is  the  Runnable  (the  job  to  do), 
and  Since  both  Monica  and  Ryan  do  the  same  thing  (check 
balance  and  withdraw  money),  we  need  only  one  instance. 

RyanAndMonicaJob  the  Job  = new  RyanAndMonicaJob  ()  ; 


Make  two  threads  with  the  same  Runnable 

(the  RyanAndMonlcaJob  instance) 


In  the  run()  method,  do 
exactly  what  Ryan  and 
Monica  would  do — check 
the  balance  and,  if 
there’s  enough  money, 
make  the  withdrawal. 


Thread  one  = new  Thread (thaJob) ; 
Thread  two  = new  Thread (the Job) ; 


^ Name  and  start  the  threads 

one . setN&me ("Ryan") ; 
two . setNaroe ( "Monica" ) ; 
one . start () ; 
two . start  ()  ; 

^ Watch  both  threads  execute  the  runO  method 

(check  the  balance  and  make  a withdrawal) 


This  should  protect 
against  overdrawing  the 
account. 

Except...  Ryan  and 
Monica  always  fall 
asleep  after  they 
check  the  balance  but 
befgre  they  finish  the 
withdrawal. 


One  thread  represents  Ryan,  the  other  represents  Monica. 

Both  threads  continually  check  the  balance  and  then  make  a 
withdrawal,  but  only  if  it's  safel 
if  (account. getBalance ()  >=  amount)  ( 
try  ( 

Thread. sleep (500) ; 

) catch (InterruptedExeeption  ex)  (ex.printStackTrace () ; ) 

> 
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The  Ryan  and  Monica  example 

class  BankAccount  { 

private  int  balance  = 100;  ^ 


public  int  getBalance()  { 
return  balance; 

} 

public  void  withdraw  (int  amount)  { 
balance  = balance  - amount; 

} 


Y>a\a <£  ?l0° 


► 


public  class  RyanAndMonicaJob  implements  Runnable  { 
private  BankAccount  account  = new  BankAccount ( ) ; 


public  static  void  main  (String  []  args)  { 

RyanAndMonicaJob  the  Job  = new  RyanAndMonica  Job  ( ) 
Thread  one  = new  Thread (the Job) ; 

Thread  two  = new  Thread (the Job) ; 
one . se tName ( "Ryan" ) ; 
two. setName ("Monica") ; 
one. start () ; 
two. start () ; 


it  (JoW 


} 


public  void  run()  { 
for  (int  x = 0;  x < 10;  x++)  { 
makeWithdrawl (10) ; 

if  (account. getBalanceO  < 0)  { a 

System . out . println  ( "Overdrawn ! " ) ; ^Vie  attowr\t  * 0 ** 


>*•  TK<*  ^ad  ihe  ***  Runnabl 

,()  3 y , .1  .1^  ^ter  ikd 

l withdrawal  wibh  eat  1 _ i~  see 


r wake  a *Wbra«a»  w.v>  --  u see ' 


Wl 


} 


} 


} 


CKetk  -the  balar^e,  a»d  >(  ^ 

^ we  just frint  a message  If  *«£ 

e«4b,  we  y>  to  *!«?.  tw  wake  u?  and 
the  withdrawal,  jwt  like  R73"  d,d’ 


is  about  to  withdraw") ; 


private  void  makeWithdrawal  (int  amount)  { 
if  (account . getBalance ()  >=  amount)  ( 

System . out . println (Thread . currentThread ( ) . ge tName ( ) + 
try  { 

System. out. println (Thread. currentThread () .ge tName ()  + " is  going  to  sleep"); 
Thread. sleep (500) ; 

} catch (InterruptedException  ex)  (ex.printStackTrace () ; ) 

Sy s tern . out . println ( Thread . currentThread ( ) . ge tName ( ) + " woke  up . " ) ; 
account. withdraw (amount) ; 

System . out . println (Thread . currentThread ( ) . ge tName ( ) + " completes  the  withdrawl " ) ; 


) 

else  { 

System. out. println ("Sorry,  not  enough  for 

} 


+ Thread . currentThread ( ) . ge tName ( ) ) ; 


wha-b  kappeh;hg  as  i i ^ns. 


*o  we  dan 
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Kyan  ana  Monica  output 


toy?**? 


| Rife  Edit  Window  Help  Visa 

Ryan  i s 

about  to 

withdraw 

Ryan  is 

going  to 

sleep 

Monica 

woke  up . 

Monica 

completes 

the  withdrawl 

Monica 

is  about  t 

o withdraw 

Monica 

is  going  to  sleep 

Ryan  wo 

ke  up. 

Ryan  co 

mpletes  th 

e withdrawl 

Ryan  is 

about  to 

withdraw 

Ryan  is 

going  to 

sleep 

Monica 

woke  up . 

Monica 

completes 

the  withdrawl 

Monica 

is  about  to  withdraw 

Monica 

is  going  t 

o sleep 

Ryan  wo 

ke  up. 

Ryan  completes  th 

e withdrawl 

Ryan  is 

about  to 

withdraw 

Ryan  is 

going  to 

sleep 

Monica 

woke  up . 

Monica 

completes 

the  withdrawl 

Sorry , 

not  enough 

for  Monica 

Sorry , 

not  enough 

for  Monica 

Sorry, 

not  enough 

for  Monica 

Sorry, 

not  enough 

£or  Monica 

Sorry, 

not  enough 

for  Monica 

Ryan  wo 

ke  up . 

Ryan  co 

mpletes  the  withdrawl 

Overdrawn? 

Sorry, 

not  enough 

for  Ryan 

Overdra 

wn  ■ 

Sorry, 

not  enough 

for  Ryan 

Overdra 

wn ! 

Sorry, 

not  enough 

for  Ryan 

Overdrawn ! 

k. 

The  makeWithdrawai()  method 
always  checks  the  balance 
before  making  a withdrawal, 
but  still  we  overdraw  the 
account. 

Here’s  one  scenario: 

Ryan  checks  the  balance,  sees  that 
there’s  enough  money,  and  then  falls 
asleep. 

Meanwhile,  Monica  comes  In  and  checks 
the  balance.  She,  too,  sees  that  there's 
enough  money.  She  has  no  Idea  that 
Ryan  Is  going  to  wake  up  and  complete  a 
withdrawal. 

Monica  falls  asleep. 

Ryan  wakes  up  and  completes  his 
withdrawal. 

Monica  wakes  up  and  completes  her 
withdrawal.  Big  Problem!  In  between  the 
time  when  she  checked  the  balance  and 
made  the  withdrawal,  Ryan  woke  up  and 
pulled  money  from  the  account. 

Monica's  check  of  the  account  was 
not  valid,  because  Ryan  had  already 
checked  and  was  still  In  the  middle  of 
making  a withdrawal. 

Monica  must  be  stopped  from  getting 
Into  the  account  until  Ryan  wakes  up  and 
finishes  his  transaction.  And  vice-versa. 
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They  need  a lock  for  account  access! 


The  lock  works  like  this; 


^ There's  a lock  associated  with  the  bank 
account  transaction  (checking  the  balance 
and  withdrawing  money).  There’s  only 
one  key,  and  it  stays  with  the  lock  until 
somebody  wants  to  access  the  account. 


The  bank  account 
transaction  is 
unlocked  when 
nobody  Is  using 
the  account. 


@ When  Ryan  wants  to  access  the  bank 

account  (to  check  the  balance  and  withdraw 
money),  he  locks  the  lock  and  puts  the  key 
in  his  pocket.  Now  nobody  else  can  access 
the  account,  since  the  key  is  gone. 


When  Ryan 
wants  to  access 
the  account,  he 
secures  the  lock 
and  takes  the  key. 


Ryan  keeps  the  key  in  his  pocket  until  he 
finishes  the  transaction.  He  has  the  only 
key,  so  Monica  can't  access  the  account 
(or  the  checkbook)  until  Ryan  unlocks  the 
account  and  returns  the  key. 

Now,  even  if  Ryan  falls  asleep  after  he 
checks  the  balance,  he  has  a guarantee 
that  the  balance  will  be  the  same  when  he 
wakes  up,  because  he  kept  the  key  while  he 
was  asleep! 


When  Ryan  is 
finished,  he 
unlocks  the  lock 
and  returns  the 
key.  Now  the  key 
is  available  for 
Monica  (or  Ryan 
again)  to  access 
the  account. 
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We  need  the  makeWithdrawal  ( ) method 
to  run  as  one  atomic  thing. 

We  need  to  make  sure  that  once  a thread  enters  the 
makeWithdrawal  ()  method,  it  must  be  allowed  to  finish  the  method 
before  any  other  thread  can  enter. 

In  other  words,  we  need  to  make  sure  that  once  a thread  has 
checked  the  account  balance,  that  thread  has  a guarantee  that  it  can 
wake  up  and  finish  the  withdrawal  before  any  other  thread  can  check  the 
account  balance! 

Use  the  synchronized  keyword  to  modify  a method  so  that  only 
one  thread  at  a time  can  access  it 

That’s  how  you  protect  the  bank  account!  You  don't  put  a lock  on 
the  bank  account  itself;  you  lock  the  method  that  does  the  banking 
transaction.  That  way,  one  thread  gets  to  complete  the  whole 
transaction,  start  to  finish,  even  if  that  thread  fells  asleep  in  the 
middle  of  the  method! 

So  if  you  don't  lock  the  back  account,  then  what  exactly  is  locked?  Is 
it  the  method?  The  Runnable  object?  The  thread  itself? 

We'll  look  at  that  on  the  next  page.  In  code,  though,  it's  quite 
simple — just  add  the  synchronized  modifier  to  your  method 
declaration: 


The  synchronized 

keyword  means  that 
a thread  needs  a key 
in  order  to  access  the 
synchronized  code. 

To  protect  your  data 
(like  the  bank  account), 
synchronize  the 
methods  that  act  on 
that  data. 


private  synchronized  void  makeWithdrawal  (int  amount)  { 


is  going  to  sleep") 


if  (account. getBalance  ()  >=  amount)  { 

System. out  .println  (Thread.  currentThread()  .getNaxoe  ()  + " is  about  to  withdraw") 
try  ( 

System . out . println  ( Thread . cur rentThread  ( ) . getName  ( ) + 

Thread. sleep(500) ; 

} catch (Int erruptedExcepti on  ex)  (ex.printStackTraae ( ) ; ) 

System. out. println (Thread. aurrentThread ()  . getName ()  + " woke  up."); 
account .withdraw (amount) ; 

System,  out.prin tin  (Thread.  currentThread  ()  . getName  ()  + " completes  the  withdrawl") ; 
) else  { 

System. out. println ("Sorry,  not  enough  for  " + Thread. currentThread ()  .getName  ())  ; 


1 


Wote  for  you  phyiiCs—  savvy  readew  yes , {he  Convention  of  the  word  'atomic*  here  docs  not  reflect 
the  whole  subatomic  parcticle  thin^.  Think  f'/ewton,  not  Eirutrin>  when  you  hear  the  word  'atomic*  in  {he 
Content  of  threads  or  transaction  Hey  its  not  0UR  Convention.  |f  1iV£  were  in  Charge,  we*d  apply 
Heisenbergs  Uncertainty  Principle  to  pretty  **uCh  everything  related  to  threads  ) 
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Using  an  object's  lock 


Every  object  has  a lock.  Most  of  the  time,  the 
sock  is  unlocked,  and  you  can  imagine  a virtual  / 
fcev  sitting  with  it.  Object  locks  come  into  play  V 
only  when  there  are  synchronized  methods.  I 
When  an  object  has  one  or  more  synchronized 
methods,  a thread  can  enter  a synchronized 
method  orri V if  the  thread  can  get  the  key  to  the 

The  locks  are  not  per  method , they  m 

are  per  object,  Tf  an  object  has  two 
synchronized  methods,  it  does  not 
simply  mean  that  you  can't  have  two 
threads  entering  the  same  method.  It 
means  you  can't  have  two  th reads  entering  V 
my  of  the  synchronized  methods. 

Think  about  it,  If  you  have  multiple 
methods  that  can  potentially  act  on  an 
object's  instance  variables,  all  those  methods  * 
need  to  be  protected  with  synchronized. 

The  goal  of  synchronization  is  to  protect 
critical  data.  But  remember,  you  don't  lock  the 
data  itself,  you  synchronize  the  methods  that 
access  that  data. 

So  what  happens  when  a thread  is  cranking 
through  its  call  stack  (starting  with  the  mn() 
method)  and  it  suddenly  hits  a synchronized 
method?  The  thread  recognizes  that  it  needs 
a key  for  that  object  before  it  can  enter  the 
method.  It  looks  for  the  key  (this  is  all  handled 
by  the  JVM;  there’s  no  API  in  Java  for  accessing 
object  locks),  and  if  the  key  is  available,  the 
thread  grabs  the  key  and  enters  the  method. 

From  that  point  forward,  the  thread  hangs  on 
to  that  key  like  the  thread's  life  depends  on 
it  The  thread  won't  give  up  the  key  until  it 
completes  the  synchronized  method.  So  while 
that  thread  is  holding  the  key,  no  other  threads 
can  enter  any  of  that  object's  synchronized 
methods,  because  the  one  key  for  tliat  object 
won't  be  available. 


Hey,  this  object’s  } 

takeMoneyO  method  is 
synchronized.  I need  to  get 
this  object's  key  before  I 
T can  go  in...  > — 


Every  Java  object  has  a lock. 
A lock  has  only  one  key. 

Most  of  the  time,  the  lock  is 
unlocked  and  nobody  cares. 

But  if  an  object  has 
synchronized  methods,  a 
thread  can  enter  one  of  the 
synchronized  methods  ONLY 
if  the  key  for  the  object's  lock 
is  available.  In  other  words, 
only  if  another  thread  hasn’t 
already  grabbed  the  one  key. 
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The  dreaded  "Lost  Update"  problem 

Here’s  another  classic  concurrency  problem,  that  comes  from  the  database  world.  It’s 
closely  related  to  the  Ryan  and  Monica  story,  but  we’ll  use  this  example  to  illustrate  a few 
more  points. 

The  lost  update  revolves  around  one  process: 

Step  1:  Get  the  balance  in  the  account 

int  i = balance; 

Step  2:  Add  1 to  that  balance 

balance  = i + 1; 

The  trick  to  showing  this  is  to  force  the  computer  to  take  two  steps  to  complete  the  change 
to  the  balance.  In  the  real  world,  you’d  do  this  particular  move  in  a single  statement: 

balance++ ; 

But  by  forcing  it  into  two  steps,  the  problem  with  a non-atomic  process  will  become  clear. 
So  imagine  that  rather  than  the  trivial  “get  the  balance  and  then  add  1 to  the  current 
balance”  steps,  the  two  (or  more)  steps  in  this  method  are  much  more  complex,  and 
couldn’t  be  done  in  one  statement. 

In  the  “Lost  Update”  problem,  we  have  two  threads,  both  trying  to  increment  the  balance. 

class  TestSync  implements  Runnable  { 


private  int  balance; 

public  void  run()  { 

for (int  i = 0;  i < 50;  i++)  { ^ 

increment ( ) ; 

System. out.prin tin ("balance  is 


tat'" 

wtv 

tat'" 


<50  V'eS> 


+ balance) ; 


> 


) 


XU  x.  — 

balance 


addi*9  / bo  i bhe  bal, 

r/^E  W£  READ  it  balaue  ** 


public  class  TestSyncTest  { 

public  static  void  main  (String []  args)  { 
TestSync  job  = new  TestSync () ; 

Thread  a = new  Thread (job) ; 

Thread  b = new  Thread (job) ; 

a.  start ()  ; 

b.  start ()  ; 


} 


} 
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Let's  run  this  code... 


^ Thread  A runs  for  awhile 

^ Put  the  value  of  balance  into  variable  i. 

Balance  is  0*  so  i is  now  0, 

Set  the  value  of  balance  to  the  result  of  i + 1 . 
Now  balance  Is  1 . 

'TAw  Put  the  value  of  balance  Into  variable  L 
Balance  Is  1 , so  I is  now  1 . 

■ I Set  the  value  of  balance  to  the  result  of  [ + 1 , 

11  Now  balance  Is  2. 


Thread  B runs  for  awhile 


Put  the  value  of  balance  into  variable  L 
Balance  Is  2,  so  i is  now  2. 

Set  the  value  of  balance  to  the  result  of  i + 1 
Now  balance  is  3. 

Put  the  value  of  balance  into  variable  i. 
Balance  Is  3,  so  I is  now  3* 

(now  thread  B is  sent  back  to  runnable, 
before  it  sets  the  value  of  balance  to  4] 


Thread  A runs  again,  picking  up  where  it  left  off 

Put  the  value  of  balance  Into  variable 
Balance  Is  3,  so  i is  now  3. 

Set  the  value  of  balance  to  the  result  of  I + 1 
Now  balance  Is  4. 

Put  the  value  of  balance  Into  variable 
Balance  Is  4,  so  I is  now  4. 

Set  the  value  of  balance  to  the  result  of  I + 1 
Now  balance  is  5, 


Thread  B runs  again,  and  picks  up  exactly  where  it  left  off! 

^ Set  the  value  of  balance  to  the  result  of  i + 1 . 

Now  balance  Is  4.  ^ 

WJ 


Thread  A updated  it  to  5,  but 
now  B ta*e  batk  and  stepped 
on  tap  at  the  update  A "^de, 
at  i.f  A's  update  never  happened. 


We  lost  the  last  updates 
that  Thread  A made! 

Thread  B had  previously 
done  a ‘read’  of  the  value 
of  balance,  and  when  B 
woke  up,  It  Just  kept  going 
as  If  it  never  missed  a beat. 
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Make  the  Increment!)  method  atomic. 
Synchronize  it! 


Synchronizing  the  increment!)  method  solves  the  “Lost 
Update”  problem,  because  it  keeps  the  two  steps  in  the  method 
as  one  unbreakable  unit, 

public  synchronized  void  increment ( ) { 
int  i = balance; 
balance  = i + 1 ; 

} 


Once  a thread  enters 
the  method,  we  have 
to  make  sure  that  all 
the  steps  in  the  method 
complete  (as  one 
atomic  process)  before 
any  other  thread  can 
enter  the  method. 


Sounds  like  it's  a good  idea  to  synchronize 


everything,  just  to  be  thread-safe. 


A- 

Nope,  it's  not  a good  Idea.  Synchronization  doesn't 
come  for  free.  First,  a synchronized  method  has  a certain 
amount  of  overhead.  In  other  words,  when  code  hits  a 
synchronized  method,  there's  going  to  be  a performance  hit 
(although  typically, you'd  never  notice  Jt)  while  the  matter  of 
"Is  the  key  available?" is  resolved. 

Second,  a synchronized  method  can  slow  your  program 
down  because  synchronization  restricts  concurrency.  In 
other  words,  a synchronized  method  forces  other  threads  to 
get  in  line  and  wait  their  turn. This  might  not  be  a problem 
In  your  code,  but  you  have  to  consider  It. 

Third,  and  most  frightening,  synchronized  methods  can  lead 
to  deadlockl  (See  page  516.) 

A good  rule  of  thumb  Is  to  synchronize  only  the  bare 
minimum  that  should  be  synchronized.  And  In  fact,  you 
can  synchronize  at  a granularity  that's  even  smaller  than 
a method.  We  don't  use  it  In  the  book,  but  you  can  use  the 
synchronized  keyword  to  synchronize  at  the  more  fine- 
grained level  of  one  or  more  statements,  rather  than  at  the 
whole-method  level. 


doS-fc^ft)  doesn't  weed  i o 
be  jynd-Vi rowzedj  **  *** 
syndwrohize  the  whole  method- 

public  void  go()  ( 
do Stuff ( ) ; 


moraCritlcalStuff  I 


have  ic  pwovid* 

will  b d°  it  you 

W ere 
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Thread  A runs  for  awhile 


Attempt  to  enter  the  increment()  method. 

The  method  is  synchronized,  so  get  the  key  for  this  object 
Put  the  value  of  balance  into  variable  i. 

Balance  is  0,  so  i is  now  0. 

Set  the  value  of  balance  to  the  result  of  i + 1 . 

Now  balance  is  1. 

Return  the  key  (it  completed  the  increment()  method). 
Re-enter  the  increment)  method  and  get  the  key. 

Put  the  value  of  balance  into  variable  i. 

Balance  is  1 , so  i is  now  1 . 


[now  thread  A is  sent  back  to  runnable,  but  since  it  has  not 
completed  the  synchronized  method,  Thread  A keeps  the  key] 


Thread  B is  selected  to  run 

1 

Attempt  to  enter  the  increment)  method.  The  method  is 
synchronized,  so  we  need  to  get  the  key. 

The  key  is  not  available. 

[now  thread  B is  sent  into  a ' object  lock  not  available  lounge] 


Thread  A runs  again,  picking  up  where  it  left  off 
(remember,  it  still  has  the  key) 

Set  the  value  of  balance  to  the  result  of  i + 1 . 

Now  balance  is  2. 

Return  the  key. 

[now  thread  A is  sent  back  to  runnable , but  since  it 
has  completed  the  increment)  method,  the  thread 
does  NOT  hold  on  to  the  key] 


Thread  B is  selected  to  run 


Attempt  to  enter  the  increment()  method.  The  method  is 
synchronized,  so  we  need  to  get  the  key. 

This  time,  the  key  IS  available,  get  the  key. 

Put  the  value  of  balance  into  variable  i. 

[continues  to  run...] 
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The  deadly  side  of  synchronization 

Be  careful  when  you  use  synchronized  code,  because  nothing 
will  bring  your  program  to  its  knees  like  thread  deadlock. 
Thread  deadlock  happens  when  you  have  two  threads,  both  of 
which  are  holding  a key  the  other  thread  wants.  There’s  no  way 
out  of  this  scenario,  so  the  two  threads  will  simply  sit  and  wait. 
And  wait.  And  wait- 

If  you’re  familiar  with  databases  or  other  application  servers, 
you  might  recognize  the  problem;  databases  often  have  a 
locking  mechanism  somewhat  like  synchronization.  But  a 
real  transaction  management  system  can  sometimes  deal  with 
deadlock.  It  might  assume,  for  example,  that  deadlock  might 
have  occurred  when  two  transactions  are  taking  too  long  to 
complete.  But  unlike  Java,  the  application  server  can  do  a 
“transaction  rollback”  that  returns  the  state  of  the  rolled-back 
transaction  to  where  it  was  before  the  transaction  (the  atomic 
pan)  began. 

Java  has  no  mechanism  to  handle  deadlock.  It  won’t  even  know 
deadlock  occurred.  So  it's  up  to  you  to  design  carefully.  If  you 
find  yourself  writing  much  multithreaded  code,  you  might 
want  to  study  "Java  Threads”  by  Scon  Oaks  and  Henry  Wong 
for  design  tips  on  avoiding  deadlock.  One  of  the  most  common 
tips  is  to  pay  attention  to  the  order  in  which  your  threads  are 
staned. 


All  it  takes  for 
deadlock  are  two 
objects  and  two 
threads. 


A simple  deadlock  scenario: 


Thread  A enters  a 
synchronized  method 
of  object  foo,  and  gets 
the  key. 


f© 


. ^Thread  A goes  to 
* ^ sleep,  holding  the 

foo  key. 


Thread  B enters  a 
synchronized  method 
of  object  bar,  and  gets 


the  key. 


T© 


Thread  B tries  to  enter 
^ a synchronized  method 
^ of  object  foo , but  can't 
get  that  key  (because 
A has  it).  B goes 
to  the  waiting  lounge, 
until  the  foo  key  Is 
available.  B keeps  the 
bar  key. 


Thread  A wakes  up  (still 
holding  the  foo  key) 
and  tries  to  enter  a 
synchronized  method  on 
object  bar , but  can't  get 
that  key  because  B has 
it.  A goes  to  the  waiting 
lounge,  until  the  bar  key  is 
available  (it  never  will  be!) 

Thread  A can't  run  until 
It  can  get  the  darkey, 
but  B is  holding  the  bar 
key  and  B can't  run  until  it 
gets  the  foo  key  that  A Is 
holding  and... 
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_ BULLET  POINTS  

■ The  static  Thread.sleepO  method  forces  a thread  to  leave  the 
running  state  for  at  least  the  duration  passed  to  the  sleep  method. 
Thread.sleep(200)  puts  a thread  to  sleep  for  200  milliseconds. 

■ The  sleepQ  method  throws  a checked  exception  (IntemjptedException), 
so  all  calls  to  sleepO  must  be  wrapped  in  a try/catch,  or  declared. 

■ You  can  use  sleepO  to  help  make  sure  all  threads  get  a chance  to  run, 
although  there's  no  guarantee  that  when  a thread  wakes  up  if  II  go  to  the 
end  of  the  runnable  line.  It  might,  for  example,  go  right  back  to  the  front. 

In  most  cases,  appropriately-timed  sleepO  calls  ar*  you  need  to  keep 
your  threads  switching  nicely. 

■ You  can  name  a thread  using  the  (yet  another  surprise)  setNameO 
method.  All  threads  get  a default  name,  but  giving  them  an  explicit  name 
can  help  you  keep  track  of  threads,  especially  if  you're  debugging  with 
print  statements. 

■ You  can  have  serious  problems  with  threads  if  two  or  more  threads  have 
access  to  the  same  object  on  the  heap. 

■ Two  or  more  threads  accessing  the  same  object  can  lead  to  data 
corruption  if  one  thread,  for  example,  leaves  the  running  state  while  still 
in  the  middle  of  manipulating  an  object's  critical  state. 

■ To  make  your  objects  thread-safe,  decide  which  statements  should  be 
treated  as  one  atomic  process.  In  other  words,  decide  which  methods 
must  run  to  completion  before  another  thread  enters  the  same  method 
on  the  same  object. 

■ Use  the  keyword  synchronized  to  modify  a method  declaration, 
when  you  want  to  prevent  two  threads  from  entering  that  method. 

■ Every  object  has  a single  lock,  with  a single  key  for  that  lock.  Most  of  the 
time  we  don’t  care  about  that  lock;  locks  come  into  play  only  when  an 
object  has  synchronized  methods. 

■ When  a thread  attempts  to  enter  a synchronized  method,  the  thread 
must  get  the  key  for  the  object  (the  object  whose  method  the  thread 
Is  trying  to  run).  If  the  key  Is  not  available  (because  another  thread 
already  has  it),  the  thread  goes  Into  a kind  of  waiting  lounge,  until  the  key 
becomes  available. 

a Even  If  an  object  has  more  than  one  synchronized  method,  there  is  still 
only  one  key.  Once  any  thread  has  entered  a synchronized  method  on 
that  object,  no  thread  can  enter  any  other  synchronized  method  on  the 
same  object  This  restriction  lets  you  protect  your  data  by  synchronizing 
any  method  that  manipulates  the  data. 
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final  chat  client 


New  and  improved  SimpleChatClient 


Way  back  near  the  beginning  of  this  chapter,  we  built  the  SimpleChatClient  that  could  send 
outgoing  messages  to  the  server  but  couldn’t  receive  anything.  Remember?  That’s  how  we 
got  onto  this  whole  thread  topic  in  the  first  place,  because  we  needed  a way  to  do  two  things 
at  once:  send  messages  to  the  server  (interacting  with  the  GUI)  while  simultaneously  reading 
incoming  messages  from  the  server,  displaying  them  in  the  scrolling  text  area. 


import  j ava . io . * ; 
import  java.net.*; 
import  java. util.*; 
import  javax. swing.*; 
import  j ava . awt . * ; 
import  j ava . awt . event . * ; 


V*  iHeire  ireallv  /S 

nd  ^hi*  chapter. 

0ut  hol  yet  . 


public  class  SimpleChatClient  { 


JTextArea  incoming; 
JTextField  outgoing; 
BufferedReadar  reader; 
PrintWriter  writer; 
Socket  sock; 


public  static  void  main (String []  args)  { 

SimpleChatClient  client  = new  SimpleChatClient () 
client. go () ; 

1 

public  void  go()  ( 


JFrame  frame  = new  JFrame  ("Ludicrously  Simple  Chat  Client"); 

JFanel  mainPanel  = new  JPanelO; 
incoming  = new  JTextArea (15,50)  ; 
incoming . setLineWrap  (true)  ; 
incoming. setWrapSty leWord ( true)  ; 
incoming. setEdi table (false) ; 

JScrollPane  qScroller  = new  JScrollPane (incoming) ; 

qScroller . setVerticalScrollBarPolicy  (ScrollPaneConstants . VERT I CAL_SCROLLBAR_ALWAYS ) ; 
qScroller . setHorizontalScrollBarPolicy  (ScrollPaneConstants . HORI  ZONTAL_SCROLLBAR_NEVER) 
outgoing  = new  JTextField (20) ; 

JButton  sendButton  = new  JButton("Send") ; 
sendButton . addActionLis tener (new  SendButtonListener ( ) ) 
mainPanel . add (qScroller) ; 
mainPanel . add (outgoing) ; 
mainPanel. add (sendButton) ; 
setUpNetworking ()  ; 


Wt\ 


frame . ge tContentPane ( ) . add (BorderLayou t . CENTER , mainPanel ) 
frame . setSize (400 , 500) ; 
frame . setVisible (true) ; 


a ww  thread, 
a *e*  miter  class  as 
the  Amiable  (job)  -for  the 

thread.  The  threads  job  is 
servers 

ket  stream,  displaymq 

^tsezsr^ 


} //  close  go 
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private  void  se tUpNe two r Icing  0 { 


try  { 

sock  = new  Socket ("127 . 0 . 0 . 1" , 5000); 

InpntS treamReader  s treamReader  - new  Xnpu tS treamReader  ( sock. getXnpu tS tream  () ) 
reader  = new  BufferedRaader  (streamReader)  ; 

writer  = new  PrintWriter  (sock.getOutputStream() ) ; , . ^ 

System. out. printin  ("networking  established")  ; n uskA.  to  ^ , j V 

) catch (IOExcaption  «x)  ( We«  aV^ 

ex . prints tackTrace  ( ) ; 


) 

} 1 1 close  setUpNecworking 


«*  ,£  2*  fte  XT* 


public  class  SendButtonldstener  implements  Actionldatener  { 
public  void  a ctionPer formed  (ActionEvent  ev)  { 
try  { 

writer ,pr in tin (outgoing. get Text () ) ; 
wri ter. flush  ()  ; 


} 


} catch (Exception  ex)  ( 
ex . prints tackTrace ( ) ; 

) 


/^‘h9  ho-t  tn4h  tie  ««■  ilicks 

k ft,n'  ^ ^ t>.e 

io*lt»ti  of  tie  tint  ^ield  ^ ^ 


server. 


outgoing, 
outgoing , 


setTaxtC'")  ; 
requestFocus () 


) //  close  inner  class 


public  class  Incoming® eader  implc 
public  void  £im()  { 

String  message; 
try  { 


its  Runnable  { 


while  ((message  = reader,  re  adLi  ne  () ) !=  null) 
System . out . println ( Hread  n + message)  ; 
incoming,  append  (message  + vv\n") ; 

) //  close  vrtiile 

} catch (Exception  ex)  (ex. prints tackTrace (); ) 

) //  close  run 
) //  close  inner  class 


! i*  7“ 

j (a*  ^ l ^\)  y-eadt^  a 
W at  a ^ ^ UW* 

the  *e^H 

Sti,  a ^ ^ ^ratirrJ. 


Imt 


} //  close  outer  class 
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Readj-fcake 
Cade 


import  java.io.*; 
import  java.net.*; 
Import  java .util . * ; 


the  really  really  simple  Chat  Server 

You  can  use  this  server  code  for  both  versions  of  the  Chat  Client.  Every  possible 
disclaimer  ever  disclaimed  is  in  effect  here.  To  keep  the  code  stripped  down  to  the 
bare  essentials,  we  took  out  a lot  of  parts  that  you'd  need  to  make  this  a real  server. 
In  other  words,  it  works,  but  there  are  at  least  a hundred  ways  to  break  iL  If  you 
want  a Really  Good  Sharpen  Your  Pencil  for  after  you’ve  finished  this  book,  come 
back  and  make  this  server  code  more  robust. 

Another  possible  Sharpen  Your  Pencil,  that  you  could  do  right  now,  is  to  annotate 
this  code  yourself.  You'll  understand  it  much  better  if  you  work  out  what’s 
happening  than  if  we  explained  it  to  you.  Then  again,  this  is  Ready-bake  code, 
so  you  really  don't  have  to  understand  it  at  all.  It’s  here  just  to  support  the  two 
versions  of  the  Chat  Client. 

| To  run  the  chat  client,  you  need  two 
terminal*.  First,  launch  this  server 
from  one  terminal,  then  launch  the 
client  from  another  terminal 


public  cla9S  Very  S imp  leChatServer  { 

ArrayList  clientOutputStreams ; 

public  class  ClientHandler  implements  Runnable  { 
BufferedReader  reader; 

Socket  sock; 


public  ClientHandler  (Socket  clientSocket)  { 
try  { 

sock  = clientSocket; 

InputStreamReader  is Reader  = new  TnputStreamReader (sock.getInputStream() ) 
reader  = new  BufferedReader (iaRaader) ; 


} catch (Exception  ex) 

} //  close  constructor 


{ ex . prints tackTrace ( ) ; ) 


public  void  run()  { 

String  message; 
try  { 

while  {(message  = reader . readLine () ) !=  null) 

System. out. println {"'read  " + message)  ; 
tellEveryone (message) ; 


} //  close  while 
} catch (Exception  ex) 

) //  close  run 
//  close  inner  class 


(ex. prints tackTrace () ; ) 
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public  static  void  main  (String {]  args)  ( 
new  VerySimpleChAtServer ( ) . go() ; 

> 

public  void  g©()  ( 

clientOutputStreams  = new  AxrayList  ( ) ; 
try  { 

ServerSocket  server Sock  = new  ServerSocket (5000) ; 
while (true)  { 

Socket  clientSocket  - serverSock, accept () ; 

PrintWriter  writer  = new  PrintWriter (clientSocket . getOutputStream() ) ; 
clientOut^utStreams . add  (writer)  ; 

Thread  t - new  Thread (new  ClientHandler (clientSocket) ) ; 
t. start ()  ; 

System. out .println ("got  a connection"); 

) 

} catch (Exception  ex)  { 
ex . prints  tack Trace ( ) ; 

) 

) //  close  go 

public  void  tellEveryone (String  message)  { 

Iterator  it  *=  clientOutputfltreams . iterator  ()  ; 
while  (it  .hasNaxt  () ) { 
try  { 

PrintWriter  writer  = (PrintWriter)  it.next() ; 
writer .println (message) ; 
writer . flush  ( ) ; 

} catch (Exception  ax)  { 

ex . prints  tack  Trace  ()  ; 

) 

) //  end  while 

) //  close  cel lEveryooe 
7 close  class 
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*XS  What  about  protecting  static 
variable  state?  If  you  have  static 
methods  that  change  the  static  variable 
state,  can  you  still  use  synchronization? 

A*  Yesl  Remember  that  static 
methods  run  against  the  class  and  not 
against  an  individual  instance  of  the  class. 
So  you  might  wonder  whose  object's  lock 
would  be  used  on  a static  method?  After 
all, there  might  not  even  beany  instances 
of  that  class.  Fortunately,  Just  as  each 
object  has  its  own  lock,  each  loaded  class 
has  a lock.  That  means  that  If  you  have 
three  Dog  objects  on  your  heap, you  have 
a total  of  four  Dog-related  locks.Three 
belonging  to  the  three  Dog  Instances, 
and  one  belonging  to  the  Dog  class  Itself. 
When  you  synchronize  a static  method, 
Java  uses  the  lock  of  the  class  itself.  So  If 
you  synchronize  two  static  methods  In  a 
single  class, a thread  will  need  the  class 
lock  to  enter  either  of  the  methods. 


'Xj*  What  are  thread  priorities?  I've 
heard  that's  a way  you  can  control 
scheduling. 

A. 

Jr\~  Thread  priorities  might  help 
you  Influence  the  scheduler,  but  they 
still  don't  offer  any  guarantee.  Thread 
priorities  are  numerical  values  that  tell 
the  scheduler  (If  It  cares)  how  Important  a 
thread  Is  to  you.  In  general,  the  scheduler 
will  kick  a lower  priority  thread  out  of  the 
running  state  If  a higher  priority  thread 
suddenly  becomes  runnable.  But...  one 
more  time,  say  it  with  me  now, "there 
Is  no  guarantee."  We  recommend  that 
you  use  priorities  only  if  you  want  to 
Influence  performance , but  never,  ever 
rely  on  them  for  program  correctness. 


o?  Why  don't  you  just  synchronize 
all  the  getters  and  setters  from  the 
class  with  the  data  you're  trying  to 
protect?  Like,  why  couldn't  we  have 
synchronized  just  the  checkBalanceO 
and  whhdrawO  methods  from  class 
BankAccount,  Instead  of  synchronizing 
the  makeWIthdrawalO  method  from 
the  Runnable's  class? 


A-  Actually,  we  should  have 
synchronized  those  methods,  to  prevent 
other  threads  from  accessing  those 
methods  In  other  ways.  We  didn't  bother, 
because  our  example  didn't  have  any 
other  code  accessing  the  account. 

But  synchronizing  the  getters 
and  setters  (or  in  this  case  the 
checkBalancef)  and  wlthdraw())  isn't 
enough.  Remember,  the  point  of 
synchronization  Is  to  make  a specific 
section  of  code  work  ATOMICALLY.  In 
other  words,  it's  not  Just  the  individual 
methods  we  care  about,  it's  methods 
that  require  more  than  one  step  to 
complete\  Think  about  It.  (f  we  had  not 
synchronized  the  makeWIthdrawalO 
method,  Ryan  would  have  checked  the 
balance  (by  calling  the  synchronized 
checkBalanceO),  and  then  Immediately 
exited  the  method  and  returned  the  key! 

Of  course  he  would  grab  the  key  again, 
after  he  wakes  up, so  that  he  can  call 
the  synchronized  withdrawO  method, 
but  this  still  leaves  us  with  the  same 
problem  we  had  before  synchronization! 
Ryan  can  check  the  balance,  go  to  sleep, 
and  Monica  can  come  in  and  also  check 
the  balance  before  Ryan  has  a chance  to 
wakes  up  and  completes  his  withdrawal. 

So  synchronizing  all  the  access  methods 
Is  probably  a good  Idea,  to  prevent 
other  threads  from  getting  in,  but  you 
still  need  to  synchronize  the  methods 
that  have  statements  that  must  execute 
as  oneatomlc  unit. 


522  chapter  15 


networking  and  threads 


* 


* 


Code  Kitcken 


* 


see 


Cyber  BeatBox 


Bass  Drum  #Q  Q 00.  □ □ □ SB.  □ □ 0 □ □ D 

Closed  Hl-Hat  OB0OO □ 0HO  □ 0 □ □ □ 0 0 

Open Hl-Hat  00000000 00000000 

Acoustic  Snare □□□□□□□□□□□□OGDQ 
Crash  Cymbal  QOOQ OOQOOQGOOOQG 
Hand  Clap  GQGQGGQGGGDGGGDQ 
High  Tom  0000000000000000 

Hi  Bongo  Q.Q QOOQ QGOO  □ □ 00 0 G 
Maracas  0040000  0 0 0O0  Q 000  G 
whistle  OOOOGGGOGQGGGOGQ 
low  Conga  GGaa  O O S 0000  00000 

cowbeii  □aooooooooooaooo 
vibrasiap  oob  dob  0 o 0.0  o □ o o o o 

Low-mldTom  OOOOOOOOOGOOOOOG 
High  Agogo  QQ 0000 DO  O 0 CO  GOOD 

Open  Hi CongaQQ Qg S-S OQOOOO000Q 


c 

Start 

3 

f 

Stop 

3 

G 

Tempo  Up  ) 

C 

Tempo 

Down  ) 

G 

send  It 

3 

dance  beat 


Andy:  groove  #2 
Chris:  groove2  revised < 
Nigel:  dance  beat 


This  is  the  last  version  ol  the  BeatBox! 


✓ ^ a*.  p\avy«'rSj  a °* -* 
'f*‘v  tv!rr 


It  connects  to  a simple  MusicServer  so  that  you  can 
sent!  and  receive  heat  patterns  with  other  clients. 

The  code  is  really  Long,  so  the  complete  listing  is 
actually  in  Appendix  A. 
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Code  Magnets 


A working  Java  program  is  scrambled  up  on  the  fridge.  Can 
you  add  the  code  snippets  on  the  next  page  to  the  empty 
classes  below,  to  make  a working  Java  program  that  pro- 
duces  the  output  listed?  Some  of  the  curly  braces  fell  on  the 
floor  and  they  were  too  small  to  pick  up,  so  feel  free  to  add  as 
many  of  those  as  you  needl 


Bonus  Question:  Why  do  you  think  we  used  the 
modifiers  we  did  in  the  Accum  class? 


Me  Edit  Wnd ow  Hdp  Sawing 


3 java  TestThreads 
one  9B09B 
two  98099 
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| Thread  one  =*  new  Thread (tl)} 
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public  class  TestThreads  { SoJlfcioQB 

public  static  void  main (String  (]  args)  { 

ThreadOne  tl  = new  ThreadOne(); 

ThreadTwo  t2  = new  ThreadTwo(); 

Thread  one  = new  Thread(tl); 

Thread  two  *=  new  Thread(t2); 


one-start( ) ; 


two-start( ) j 


} 


class  Accum  { 

private  static  Accum  a = new  Accum(); 
private  int  counter  = 0; 


private  Accum ()  { > 


public  static  Accum  getAccum()  { 
return  a; 

y 


public  void  updateCounter ( int  add)  { 
counter  +«  add; 

} 


Threads  from  two  different  classes  are  updating 
the  same  object  in  a third  class,  because  both 
threads  are  accessing  a single  instance  of  Accum. 
The  line  of  code: 

private  static  Accum  a = new  Accum( );  creates  a 
static  instance  of  Accum  (remember  static  means 
one  per  class),  and  the  private  constructor  in 
Accum  means  that  no  one  else  can  make  an  Accum 
object.  These  two  techniques  (private  constructor 
and  static  getter  method)  used  together,  create 
what's  known  as  a 'Singleton'  - an  00  pattern  to 
restrict  the  number  of  instances  of  an  object 
that  can  exist  in  an  application.  (Usually,  there's 
just  a single  instance  of  a Singleton—hence  the 
name),  but  you  can  use  the  pattern  to  restrict  the 
instance  creation  in  whatever  way  you  choose.) 


public  int  getCount()  { 
return  counter; 

> 

> 

class  ThreadOne  implements  Runnable  { 

Accum  a = Accum- getAccum(  ) ; 
public  void  run()  { 

for  (int  x=*0 ; x < 98;  x++)  { 
a- updateCounter (1000) ; 
try  { 

Thread- sleep (50) ; 

> catch ( interruptedException  ex)  { } 

} 

System. out. println( "one  "+a.getCount( ) ) ; 


class  ThreadTwo  implements  Runnable  { 

Accum  a = Accum- getAccum( ) ; 
public  void  run ( ) { 

for(int  x=0;  x < 99;  X++-)  { 
a . updateCounter ( 1 ) ; 
try  { 

Thread . sleep ( 50 ) ; 

) catch (InterruptedException  ex)  ( } 

> 

System. out .println ( "two  "+a.getCount( ) ) ; 


y 


> 
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flve-J^lnufe 

Mystery 


Near -miss  at  the  Airlock 

As  Sarah  joined  the  on-board  development  team’s  design  review  meeting , she  gazed  out 
the  portal  at  sunrise  over  the  Indian  Ocean.  Even  though  the  ship's  conference  room  was 
incredibly  claustrophobic,  the  sight  of  the  growing  blue  and  white  crescent  overtaking  night  on 
the  planet  below  filled  Sarah  with  awe  and  appreciation. 

This  morning’s  meeting  was  focused  on  the  control  systems  for  the  orbiter’s  airlocks. 
As  the  final  construction  phases  were  nearing  their  end,  the  number  of  spacewalks  was 
scheduled  to  increase  dramatically,  and  traffic  was  high  both  in  and  out  of  the  ship’s 
airlocks.  “Good  morning  Sarah”,  said  Tom,  “Your  timing  is  perfect,  we’re  just  starting 
the  detailed  design  review.” 


“As  you  all  know”,  said  Tom,  “Each  airlock  is  outfitted  with  space-hardened  GUI 
terminals,  both  inside  and  out  Whenever  spacewalkers  are  entering  or  exiting  the  orbiter 
they  will  use  these  terminals  to  initiate  the  airlock  sequences.”  Sarah  nodded,  'Tom  can 
you  tell  us  what  the  method  sequences  are  for  entry  and  exit?”  Tom  rose,  and  floated  to  the 
whiteboard,  “First,  here’s  the  exit  sequence  method’s  pseudocode”,  Tom  quickly  wrote  on  the 
board. 

orbiterAirlockExitSequerice { ) 
verifyPortalStatus ()  ; 
pressurizeAirlock () ; 
openlnnerHatch () ; 
conflrmAirlockOccupied  () ; 
closelnnerHatch  () ; 


decompressAirlock  () ; 
openOuterHatch () ; 
confirmAirlockVacated  ( ) ; 


closeOuterHatch () ; 

‘To  ensure  that  the  sequence  is  not  interrupted,  we  have  synchronized  all  of  the 
methods  called  by  the  orbiterAirlockExitSequenceO  method”,  Tom  explained.  “We’d  hate  to 
see  a returning  spacewalker  inadvertently  catch  a buddy  with  his  space  pants  down!” 

Everyone  chuckled  as  Tom  erased  the  whiteboard,  but  something  didn’t  feel  right 
to  Sarah  and  it  finally  clicked  as  Tom  began  to  write  the  entry  sequence  pseudocode  on  the 
whiteboard.  “Wait  a minute  Tom!”,  cried  Sarah,  T think  we’ve  got  a big  flaw  in  the  exit 
sequence  design,  let’s  go  back  and  revisit  it,  it  could  be  critical!” 

Why  did  Sarah  stop  the  meeting?  What  did  she  suspect? 
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What  did  Sarah  know? 


Sarah  realized  that  in  order  to  ensure  that  the  entire  exit 
sequence  would  run  without  interruption  the 

orbiterAirlockExitSequence( ) method  needed  to 
be  synchronized.  As  the  design  stood,  it  would  be  possible 
for  a returning  spacewalker  to  interrupt  the  Exit  Sequence! 
The  Exit  Sequence  thread  couldn't  be  interrupted  in  the 
middle  of  any  of  the  lower  level  method  calls,  but  it  could  be 
interrupted  in  between  those  calls.  Sarah  knew  that  the  entire 
sequence  should  be  run  as  one  atomic  unit,  and  if  the  orbit 
erAirlockExitSequence ( ) method  was  synchronized,  it 
could  not  be  interrupted  at  any  point 
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Sorting  is  a snap  in  Java.  You  have  all  the  tools  for  collecting  and  manipulating 
your  data  without  having  to  write  your  own  sort  algorithms  (unless  you're  reading  this  right 
now  sitting  in  your  Computer  Science  101  class,  in  which  case,  trust  us— you  are  SO  going  to  be 
writing  sort  code  while  the  rest  of  us  just  call  a method  In  the  Java  API).  The  Java  Collections 
Framework  has  a data  structure  that  should  work  for  virtually  anything  you'll  ever  need  to  do. 
Want  to  keep  a list  that  you  can  easily  keep  adding  to?  Want  to  find  something  by  name?  Want 
to  create  a list  that  automatically  takes  out  all  the  duplicates?  Sort  your  co-workers  by  the 
number  of  times  they've  stabbed  you  in  the  back?  Sort  your  pets  by  number  of  tricks  learned? 
It's  all  here... 
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Tracking  song  popularity  on  your  jukebox 

Congratulations  on  your  new  job — managing  the  automated 
jukebox  system  at  Lou's  Diner  There's  no  Java  inside  the 
jukebox  itself,  but  each  time  someone  plays  a song,  the 
song  data  is  appended  to  a simple  text  file. 

Your  job  is  to  manage  the  data  to  track  song  popularity, 
generate  reports,  and  manipulate  the  playlists.  You're  not 
writing  the  entire  app — some  of  the  other  software  developer/ 
waiters  are  involved  as  well,  but  you're  responsible  for  managing 
and  sorting  the  data  inside  the  Java  app.  And  since  Lou  has  a thing 
against  databases,  this  is  strictly  an  in-memory  data  collection.  All 
you  get  is  the  file  the  jukebox  keeps  adding  to.  Your  job  is  to  take  it 
from  there. 

You've  already  figured  out  how  to  read  and  parse  the  file,  and  so  far 


Challenge  #1 

Sort  the  songs  in  alphabetical  order 

You  have  a list  of  songs  in  a file,  where  each  line 
represents  one  song,  and  the  title  and  artist  are 
separated  with  a forward  slash.  So  it  should  be  simple 
to  parse  the  line,  and  put  all  the  songs  in  an  ArrayList, 

Your  boss  cares  only  about  the  song  titles,  so  for  now 
you  can  simply  make  a list  that  just  has  the  song  titles. 

But  you  can  see  that  the  list  is  not  in  alphabetical 
order...  what  can  you  do? 

You  know  that  with  an  ArrayList,  the  elements  are 
kept  in  the  order  in  which  they  were  inserted  into  the 
list,  so  putting  them  in  an  ArrayList  won't  take  care  of 
alphabetizing  them,  unless...  maybe  there's  a sort() 
method  in  the  ArrayList  class? 

vir'rUs*  data- 


you've  been  storing  the  data  in  an  ArrayList 


SongList.txt 


Pink  Moon/Nick  Drake 
Somersault/Zaro  7 
Shiva  Moon/ Pram  Joshua 
Circles/BT 

Deep  Channel /Afro  Celts 
Passenger /Headmix 
Listen/Tahiti  80 


14 


M.  IrV, 
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Here's  what  you  have  so  far  without  the  sort: 


import  java. util.*; 
import  java.io.*; 

public  class  Jukeboxl  { uT 

ArrayLiat<String>  songList  = new  ArrayList<String> ( ) ; 

public  static  void  main (String ( ) args)  { 
new  Jukeboxl () .go  0 ; 


} 


public  void  go  ()  { 
getSongs { ) ; 

System.out .print In (songList) ; 


J ILai  stav-U  the 

The  "^hoo  th  . , l.  t0*te»\V  °* 

it,  OWvALut  n^a7U 


the  fl'e  ^ 

- ' A W- 


void  gatSongsO  { 
try  { 

File  file  = new  File  ("SongList . txt")  ; 

Buf feredReader  reader  = new  BufferedReader (new  FileReader (file) ) ; 
String  line  = null; 

while  ((line=  reader . readLine () ) i=  null)  { 
addSong (line) ; 

} 


) catch  (Exception  ex)  { 
ex.printStackTrace () ; 

) 


} 


void  addSong  (String  lineToP&rae)  { 

String [ ] tokens  = lineToParse , split  OV")  ; 
songList . add (tokens [0] ) ; 


FiU  5<ift  Wlodo*  help  pence 


%java  Jukeboxl 
[Pink  Moon,  Somersault, 
Shiva  Moon,  Circles, 
Deep  Channel,  Passenger, 
Listen 1 


added  ^ the  A-List  ^.eh 
:X  ^e  order  the  J-Jjf  ^ - 

m * WT  **kabeti“  ! 
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Pot  the  ArrayList  class  does  NOT  have  a sortO  method! 
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I do  see  a collection  class 
called  TreeSet...  and  the  docs 
say  that  it  keeps  your  data 
sorted.  I wonder  if  I should  be 
using  a TreeSet  instead  of  an 
/ArrayList... 


ArrayList  is  not  the  only  collection 


Although  ArrayList  is  the  one  you’ll  use  most  often, 
there  are  others  for  special  occasions.  Some  of  the  key 
collection  classes  include: 


TreeSet 

Keeps  the  elements  sorted  and  prevents  duplicates. 


> HashMap 

Lefs  you  store  and  access  elements  as  name/value  pairs. 


> UnkedList 

Designed  to  give  better  performance  when  you  insert  or  delete 
elements  from  the  middle  of  the  collection.  (In  practice,  an 
ArrayList  is  still  usually  what  you  want.) 


> HashSet 

Prevents  duplicates  in  the  collection,  and  given  an  element,  can 
find  that  element  in  the  collection  quickly. 


> LinkedHashMap 

Like  a regular  HashMap,  except  it  can  remember  the  order  in 
which  elements  (name/value  pairs)  were  inserted,  or  it  can  be 
configured  to  remember  the  order  In  which  elements  were  last 
accessed. 
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You  could  use  a TreeSet,.. 

Or  you  could  use  the  Cq|lections.sort()  method 


If  you  put  all  the  Strings  (the  song  titles)  into  a TreeSet  instead  of 
an  ArrayList,  the  Strings  would  automatically  land  in  the  right  place, 
alphabetically  sorted.  Whenever  you  printed  the  list,  the  elements  would 
always  come  out  in  alphabetical  order. 

And  that’s  great  when  you  need  a set  (we'll 
talk  about  sets  in  a few  minutes)  or  when 
you  know  that  the  list  must  akvays  stay 
sorted  alphabetically 

On  the  other  hand,  if  you  don't  need  the 
list  to  stay  sorted,  TreeSet  might  be  more 
expensive  than  you  need — every  time  you 
insert  into  a TreeSet^  the  TreeSet  has  to  take 
the  time  to  figure  out  where  in  the  tree  the  new 
element  must  go.  With  ArrayList,  inserts  can 
be  blindingly  fast  because  the  new  element 
just  goes  in  at  the  end. 


lava.utll-Coltections 


public  static  void  copy{List  destination,  List  source) 

public  static  list  emptyList() 
public  static  void  flIHUst  IlstToFill,  Object  objToFillltWith) 
public  static  Int  frequency(Collection  c,  Object  o) 
public  static  void  reversed  list) 
public  static  void  rotate(Llst  list,  Int  distance) 
public  static  vnidshuffle^Ugjist) 
public  static  wd  sort^List  list) 


% But  you  CAN  add  something  to  an 
ArrayList  at  a specific  index  instead  of  just  at 
the  end — there's  an  overloaded  add()  method 
that  takes  an  Int  along  with  the  element  to  add. 

So  wouldn't  ft  be  slower  than  Inserting  at  the  end? 


public  static  boolej 
II  many  more  met) 


MU et  nhiftri oldVal. Object neuA/al) 


A: 


L-  Yes,  It's  slower  to  insert  something  in  an  ArrayList 
somewhere  other  than  at  the  end.  So  using  the  overloaded 
adddndex,  element)  method  doesn't  work  as  quickly  as  calling 
the  add(element)— which  puts  the  added  element  at  the  end. 
But  most  of  the  time  you  use  ArrayLlsts,you  won't  need  to  put 
something  at  a specific  index. 


»»»».,  ttwe  IS  iurtOttH 
>»  tk<  Collteiietu  Cliu  ft  ^ 

* i-irt,  M ,i,fe  An-ayLai 

'"flemntt  LW  bin**, 

/WjjrUt  K-A  ut  ThaiJa 

*•  fiu 
A»ayU,i  i*  a 

to  Ukt  List. 


Q;  I see  there's  a Linked  List  class,  so  wouldn't  that  be  better  for 
doing  Inserts  somewhere  In  the  middle?  At  least  If  I remember  my  Data 
Structures  class  from  college... 


A- 

Yes,  good  spot.The  LinkedLlst  can  be  quicker  when  you  Insert  or 
remove  something  from  the  middle,  but  for  most  applications,  the  difference 
between  middle  inserts  into  a LinkedLlst  and  ArrayList  Is  usually  not  enough 
to  care  about  unless  you're  dealing  with  a huge  number  of  elements.  We'll 
look  more  at  LinkedLlst  In  a few  minutes. 


KPT  to*  real 
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Adding  Collections.sortl)  to  the  Jukebox  code 

import  java .util.*; 
import  java.io.*; 

public  class  Jukeboxl  f 

ArrayList<String>  songList  = new  ArrayList<String> ( ) ; 

public  static  void  main  (String M args)  { 
new  Jukebox  1 ()  ,go<)  ; 

} 

public  void  go()  f 
get. Songs  ( ) ; 

System, out .println (songList) ; 

Collections. sort (songList) ; ^ 

System,  out .println (songList) ; 

) 

void  getSongs  ()  { 

try  { 

File  file  - new  File  ('"SongList . txt" ) ; 

Buf  feredReader  reader  = new  Buf  feredReader  (new  FineReader  (file)  ) ; 
String  line  = null; 

while  ( (line=  reader . readLine () ) !-  null)  ( 

addSong (line) ; 

} 

) catch (Exception  ex)  { 
ex . printStackTrace ( ) ; 

) 

} 


IV  ibtiL  ColletW 


The  Colleetions.sort() 
method  sorts  a list  of 
String  alphabetically. 


void  addSong (String  lineToParse)  ( 

String[]  tokens  - lineToParse. split  ("/") ; 
songList . add [tokens  fQJ ) ; 

1 

} 


| File  Ecfit  WirtOC w Hglp  Chill  | 


%java  Jukeboxl 

[Pink  Moon,  Somersault,  Shiva  Moon,  Circles,  Deep 
Channel,  Passenger,  Listen] 

(Circles,  Deep  Channel,  Listen,  Passenger,  Pink 
Moon,  Shiva  Moon,  Somersault] 
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Put  now  you  need  Song  objects, 
not  Just  simple  Strings. 


Now  your  boss  wants  actual  Song  class  instances  in  the  list,  notjust 
Strings,  so  that  each  Song  can  have  more  data.  The  newjukebox 
device  outputs  more  information,  so  this  time  the  file  will  have  four 
pieces  (tokens)  instead  of  just  two. 

The  Song  class  is  really  simple,  with  only  one  interesting  feature — 
the  overridden  toString()  method.  Remember,  the  toStringO 
method  is  defined  in  class  Object,  so  every  class  in  Java  inherits  the 
method.  And  since  the  toStringO  method  is  called  on  an  object 
when  its  printed  (Systera.ouLprintln(anObject)),  you  should 
override  it  to  print  something  more  readable  than  the  default 
unique  identifier  code.  When  you  print  a list,  the  toStringO 
method  will  be  called  on  each  object- 


class  Song  ( 

String  title; 
String  artist;  / 
String  rating;/ 
String  bpm;  j 


^ attribute*  <"  ^ 


SoogUstMore.txt 


Pink  Moon/Nick  Drake/S/80 

Somersault/2ero  7/4/84 

Shiva  Moon/Prem  Joshua/6/120 

Circles/BT/5/110 

Deep  Channel/Afro  Celts/4/120 

Passenger/Headmix/4/100 

Listen/Tahiti  80/5/90 


TJse  r*w  sot.3  -Pile  hold*  Sew. 

•rctt-ibu-fce  i^tead  J; 

*e  All  of  ti**  in 
liit,  it,  we  »»eed  L>  make  a 
class  wiOi  instate  variables  for  all 
song  attributes 


Song(String  t,  String  a,  String  r.  String  b)  { 
title  = t; 

artist  - a;  The  variables  are  all  set  i* 

rating  - r;  ihe  Cowtructor  when  the 

bpm  - b,  we*  £0^  iS  Created- 


public  String  getTitleO  ( 
return  title; 

) 

public  String  getArtistO  { 
return  artist; 

} 

public  String  getRatingO  { 
return  rating; 

) 

public  String  getBpmO  [ 
return  bpm; 

1 


TV>e  aeJrbcv  »etWs  far 
the  Pour  attribute*- 


public  String  toStringO 
return  title; 

) 
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Changing  the  Jukebox  code  to  use  Songs 
instead  of  Strings 

Your  code  changes  only  a little — the  file  I/O  code  is  the  same, 
and  the  parsing  is  the  same  (String.splitO),  except  this  time 
there  will  be  four  tokens  for  each  song/line,  and  all  four  will  be 
used  to  create  a new  Song  object.  And  of  course  the  ArrayList 
will  be  of  type  <Song>  instead  of  <String>. 


import 

import 


public 


j ava . util . ^ 
java.io. *; 

class  Jukebox3  { 


t.  *>  H'H*  °*  ^ 


ArrayList<Song>  songList  - new  ArrayList<Song> () ; 

public  static  void  main (String []  args)  { 
new  Jukebox3 O . go () ; 


} 


public  void  go  ()  { 
getSongs () ; 

System. out .println {songList) ; 

Collections . sort (songList) ; 

System. out .print In (songList) ; 

1 

void  getSongs ()  { 

try  { 

File  file  = new  File  (''SongList.  txt")  ; 

Buf f eredReader  reader  * new  Buf feredReader (new  FileReader (file) ) ; 
String  line  = null; 

while  ((line-  reader . readLine () ) !=  null)  { 

addSong (line) ; 

} 


) 


} catch (Exception  ex)  ( 
ex.printStackTrace () ; 

} 


void  addSong (String  lineToParse)  { 

String!]  tokens  = lineToParse. split ("/") ; 


Song  nextSong  = new  Song (tokens [0] , tokens [1]  , tokens [2],  tokens [3]); 
songList . add (nextSong) ; 

okj“t  •*» 
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It  won't  compile! 

Something's  wrong...  the  Collections  class  clearly  shows  there’s  a 
sort()  method,  that  takes  a List. 

ArrayList  is-a  List,  because  ArrayList  implements  the  List  interface, 
so...  it  should  work. 

But  it  doesn’t! 

The  compiler  says  it  can’t  find  a sort  method  that  takes  an 
ArrayList<Song>,  so  maybe  it  doesn't  like  an  ArrayList  of  Song 
objects?  It  didn't  mind  an  ArrayList<String>l  so  what's  the 
important  difference  between  Song  and  String?  What's  the 
difference  that’s  making  the  compiler  fail? 


| Flic  Edit  Window  Hdft  fojfflfnar 


%javac  Jukebox3 > java 

JukeboxB . java : 15  : cannot  find  symbol 

symbol  : method  sort (java. util . ArrayList<Song>) 

location : class  java . util . Collections 

Collections . sort (songList) ; 

A 

1 error 


And  of  course  you  probably  already  asked  yourself,  ‘'What  would  it 
be  sorting  on?”  How  would  the  sort  method  even  know  what  made 
one  Song  greater  or  less  than  another  Song?  Obviously  if  you  want 
the  song's  title  to  be  the  value  that  determines  how  the  songs  are 
sorted,  you'll  need  some  way  to  tell  the  sort  method  that  it  needs 
to  use  the  title  and  not,  say,  the  beats  per  minute. 

We'll  get  into  all  that  a few  pages  from  now,  but  first,  let's  find  out 
why  the  compiler  won't  even  let  us  pass  a Song  ArrayList  to  the 
$ort()  method. 
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The  sort 0 method  declaration 


Collections  (Java  2 Platform  SE  5.0) 


///Users/kathiy/Pubiic/docs/api/index.htmi 


' Coogle 


Method  Detail 


sort 


public  statical?  extends  Courts rable<?  super  T»  >oid  io 


Sorts  the  specified  list  into  ascending  order,  according  to  the  natural  ordering  of  its  elements.  All 
elements  in  the  list  must  implement  the  comparable  interface.  Furthermore,  all  dements  in  the  list 
must  b t mutually  comparable  (that  is,  el.compareTo[e2)  must  not  throw  a ciasaCaatExceptlon 
for  any  elements  ei  and  ei  in  the  list). 


From  the  API  docs  (looking  up  the  java.util. Collections  class,  and  scrolling  to  the  sort{) 
method),  it  looks  like  the  sort()  method  is  declared...  strangely.  Or  at  least  different  from 
anything  we've  seen  so  far. 

That's  because  the  sort()  method  (along  with  other  things  in  the  whole  collection  framework  in 
Java)  makes  heavy  use  of  generics.  Anytime  you  see  something  with  angle  brackets  in  Java  source 
code  or  documentation,  it  means  generics — a feature  added  to  Java  5.0.  So  it  looks  like  we’ll 
have  to  leam  how  to  interpret  the  documentation  before  we  can  figure  out  why  we  were  able  to 
sort  String  objects  in  an  ArrayList,  but  not  an  ArrayList  of  Song  objects. 
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(retteries  weans  wore  type-safety 


We'll  just  say  it  right  here — virtually  all  of  the  code  you  write  that  deals 
with  generics  will  be  collection-related  code . Although  generics  can  be  used 
in  other  ways,  the  main  point  of  generics  is  to  let  you  write  type-safe 
collections.  In  other  words,  code  that  makes  the  compiler  stop  you 
from  putting  a Dog  into  a list  of  Ducks. 


Before  generics  (which  means  before  Java  5.0),  the  compiler  could 
not  care  less  what  you  put  into  a collection,  because  all  collection 
implementations  were  declared  to  hold  type  Object.  You  could  put 
anything  in  any  ArrayList;  it  was  like  all  ArrayLists  were  declared  as 
ArrayList<Object>. 


WITHOUT  generics 

Objects  go  IN  as  a reference  to 
SoccerBall,  Fish,  Guitar,  and 
Car  objects 


4 4 4 4 


ArrayList 


4 4 4 4 


And  come  OUT  as  a reference  of  type  Object 


Wall  generics,  you  can 
create  type-safe  collections 
where  more  problems  are 
caught  at  compile-time 
instead  of  runtime. 

Without  generics,  the 
compiler  would  happily  let 
you  put  a Pumpkin  into  an 
ArrayList  to  was  supposed 
to  hold  only  Cat  objects. 


WITH  generics 

Objects  go  IN  as  a reference  to 


only  Fish  objects 


l l l l 


ArrayList<Fish> 


4 4 4 4 


And  come  out  as  a reference  of  type  Fish 
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Learning  generics 

Of  the  dozens  of  things  you  could  learn  about  generics,  there  are 
really  only  three  that  matter  to  most  programmers: 


^ Creating  instances  of  generified  c/asses  (like  ArrayList) 

When  you  make  an  ArrayList,  you  have  to  tell  it  the  type 
of  objects  you’ll  allow  in  the  list,  just  as  you  do  with  plain 
old  arrays. 


new  ArrayList<Song>() 


£ Declaring  and  assigning  variables  of  generic  types 

How  does  polymorphism  really  work  with  generic 
types?  If  you  have  an  ArrayList<Animal>  reference 
variable,  can  you  assign  an  ArrayList<Dog>  to  it?  What 
about  a List<Animal>  reference?  Can  you  assign  an 
ArrayList<Animal>  to  it?  You’ll  see... 


List<Song>  songList  = 

new  ArrayList<Song>() 


£ Declaring  (and  invoking)  methods  that  take  generic  types 

If  you  have  a method  that  takes  as  a parameter,  say,  an  void  foo  (List<Song>  list) 

ArrayList  of  Animal  objects,  what  does  that  really  mean? 

Can  you  also  pass  it  an  ArrayList  of  Dog  objects?  We’ll  x foo  (songList) 

look  at  some  subtle  and  tricky  polymorphism  issues  that 
are  very  different  from  the  way  you  write  methods  that 
take  plain  old  arrays. 

(This  is  actually  the  same  point  as  #2,  but  that  shows  you 
how  important  we  think  it  is.) 


But  don't  I also  need  to  learn  how  to  create  my  OWN  generic 
dasses?  What  if  I want  to  make  a class  type  that  lets  people 
instantiating  the  class  decide  the  type  of  things  that  class  will  use? 

A* 

You  probably  won't  do  much  of  that.  Think  about  it — the  API 
designers  made  an  entire  library  of  collections  classes  covering  most  of 
the  data  structures  you'd  need,  and  virtually  the  only  type  of  classes  that 
really  need  to  be  generic  are  collection  classes.  In  other  words,  classes 
designed  to  hold  other  elements,  and  you  want  programmers  using  it  to 
specify  what  type  those  elements  are  when  they  declare  and  instantiate 
the  collection  class. 

Yes,  it  is  possible  that  you  might  want  to  create  generic  classes,  but  that's 
the  exception,  so  we  won't  cover  it  here.  (But  you'll  figure  it  out  from  the 
things  we  do  cover,  anyway.) 
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Using  generic  CLASSES 

Since  ArrayList  is  our  most-used  generified  type,  we’ll 
start  by  looking  at  its  documentation.  They  two  key  areas 
to  look  at  in  a generified  class  are: 

1)  The  class  declaration 

3)  The  method  declarations  that  let  you  add  elements 


Understanding  ArrayList  documentation 
(Or,  what's  the  true  meaning  of  *E"?) 


Think  of  TT  as  a stand-in  for 
"flie  type  of  element  you  want 
this  collection  to  hold  and 
return.”  (E  is  for  Element.) 


Active 

public  class  ArrayList<E>  extends  AbstractList<E>  implements  Iiist<E> 


\ 


'C 


..  { 


public  boolean  add(E  o) 

Here's  the  imforb«t  fart!  Whatever  "E’  is 
determines  what  kind  of  ihmy  yo*re  allowed 
to  add  to  the  ArrayList 


The  tyfe  (the  value  of  <E>) 
betomcs  ike  iy?€ 
intarfd£e  as  well. 


//  more  code 


The  “E”  represents  the  type  used  to  create  an  instance 
of  ArrayList.  When  you  see  an  “E”  in  the  ArrayList 
documentation,  you  can  do  a mental  find/ replace  to 
exchange  it  for  whatever  <type>  you  use  to  instantiate 
ArrayList. 

So,  new  ArrayList<Song>  means  that  “E”  becomes  “Song”, 
in  any  method  or  variable  declaration  that  uses  “E”. 
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Using  type  parameters  with  Arraylist 

THIS  code: 

ArrayList<String>  thisList  - new  ArrayList<String> 

Means  ArrayLlst: 

public  class 

public  boolean  add 
//  more  code 

> 

Is  treated  by  the  compiler  as: 

public  class  AxrayList<String>  extends  AbstractList<String>4  . * { 

public  boolean  add  (String  o) 

//  more  code 

} 

In  other  words,  the  WE*  is  replaced  by  the  real  type  (also  called  the  type  parameter) 
that  you  use  when  you  create  the  ArravList  And  that's  why  the  add()  method 
for  ArrayList  won't  let  you  add  anything  except  objects  of  a reference  type  that's 
compatible  with  the  type  of  “E”.  So  if  you  make  an  ArrayList<Strmg>,  the  add() 
method  suddenly  becomes  add(String  o) . If  you  make  the  Arraylist  of  type  Dog, 
suddenly  the  add{)  method  becomes  add(Dog  o). 


* Is  "E"  the  only  thing  you  can  put  there?  Because  the  docs  for  sort  used"T»,- 

A- 

*1-  You  can  use  anything  that's  a legal  Java  Identifier.  That  means  anything  that  you 
could  use  for  a method  or  variable  name  will  work  as  a type  parameter.  But  the  conven- 
tion is  to  use  a single  letter  (so  that's  what  you  should  use),  and  a further  convention  is  to 
use  "T”  unless  you're  specifically  writing  a collection  class,  where  you'd  use"E"to  repre- 
sent the^type  of  the  Element  the  collection  will  hold" 
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Using  generic  METHODS 


A generic  class  means  that  the  class  declaration  includes  a type 
parameter.  A generic  method  means  that  the  method  declaration 
uses  a type  parameter  in  its  signature. 

You  can  use  type  parameters  in  a method  in  several  different  ways: 


Using  a type  parameter  defined  In  the  class  declaration 

public  class  ArrayList<E>  extends  AbstractList<E>  , . . { 

public  boolean  add(E  o) 

K ^ bn  » 

*-* * 

When  you  declare  a type  parameter  for  the  class,  you  e 

can  simply  use  that  type  any  place  that  you’d  use  a 
real  class  or  interface  type.  The  type  declared  in  the 
method  argument  is  essentially  replaced  with  the  type 
you  use  when  you  instantiate  the  class. 


Using  a type  parameter  that  was  NOT  defined  In  the  class  declaration 


public  <T  extends  Animal>  void  take  Thing  (Array  Li  st<T>  list) 


If  the  class  itself  doesn’t  use  a type  parameter,  you  can  still 
specify  one  for  a method,  by  declaring  it  in  a really  unusual 
(but  available)  space — before  ike  return  type.  This  method  says 
that  T can  be  "any  type  of  AnimaT. 


sat  <7> 

met 
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Wait...  that  can't  be  right.  If  you  can 
take  o list  of  Animal,  why  don't  you 
just  SAY  that?  What's  wrong  with  just 
takeThlng(ArrayUst*  Animal > llst)7 


Here's  where  it  gets  weird... 


This: 

public  <T  extends  Animal>  void  takeThing(ArrayList<T>  list) 
Is  NOT  the  same  as  this: 

public  void  takeThing  ( ArrayList<Animal>  list) 


Both  are  legal,  but  they're  different 

The  first  one,  where  <T  extends  Animal>  is  part  of  the  method 
declaration,  means  that  any  ArrayList  declared  of  a type  that  is 
Animal,  or  one  of  Animal's  subtypes  (like  Dog  or  Cat),  is  legal. 
So  you  could  invoke  the  top  method  using  an  ArrayLis  t<Dog>, 
ArrayList<Cat>,  or  ArrayList<Animal>, 


But,.,  the  one  on  the  bottom,  where  the  method  argument  is 
(ArrayList<Animal>  list)  means  that  only  an  ArrayLis t<Animal> 
is  legal.  In  other  words,  while  the  first  version  takes  an  ArrayList 
of  any  type  that  is  a type  of  Animal  (Animal,  Dog,  Cat,  etc.), 
the  second  version  takes  only  an  ArrayList  of  type  Animal.  Not 
ArrayList<Dog>,  or  ArrayLis  t<Cat>  but  only  ArrayList<Animal>. 

And  yes,  it  does  appear  to  violate  the  point  of  polymorphism, 
but  it  will  become  clear  when  we  revisit  this  in  detail  at  the  end 
of  the  chapter.  For  now,  remember  that  weVe  only  looking  at 
this  because  we're  still  trying  to  figure  out  how  to  sort()  that 
SongList,  and  that  led  us  into  looking  at  the  API  for  the  sort() 
method,  which  had  this  strange  generic  type  declaration. 


For  now,  all  you  need  to  know  is  that  the  syntax  of  the  top  version 
is  legal,  and  that  it  means  you  can  pass  in  a ArrayList  object 
instantiated  as  Animal  or  any  Animal  subtype. 


And  now  back  to  our  sort()  method... 


you  are  here  * 545 


sorting  a Song 


This  stilt  doesn't 
explain  why  the  sort  method 
failed  an  an  ArrayList  of  Sorvgs 
but  worked  for  an  ArrayList  of 
Strings... 


import  java . util . A; 
import  java.io.*; 


Remember  where  we  were. 


| nis  Edil  Window  Help  EkjrTvner 

%javac  Jukebox3 . java 

Jukebox3 . 

java:  15:  cannot  find  symbol 

symbol 

: method  sort (java. util. ArrayList<Song>) 

location : 

: class  java. util. Collections 

1 error 

Collections. sort (songList) ; 

A 

public  class  Jukebox3  ( 

ArrayList<Song>  songList  = new  ArrayLiat<Song>() ; 

public  static  void  main (String [ ] argsl  { 
new  Jukebox3 ( ) . go ( ) ; 

I 


public  void  go()  { 
getSongs ( ) ; 

System. out. println (songList)  ; 

Collections . sort (songList) ; 

System. out . println (songList) ; 

} 


tv.,!  * it  « •“ 


void  getSongs  ()  ( 

try  ( 

File  file  = new  File  ("SongList . txt")  ; 

Buf feredReader  reader  = new  Buf feredReader (new  FileReader  (file)  ) ; 
String  line  = null; 

while  ( (line=  reader . readLine O ) !=  null)  { 

addSong (line) ; 

> 

) catch (Exception  ex)  { 
ex .printStackTrace  0 ; 

) 

) 


void  addSong (String  lineToParae)  ( 

String!)  tokens  = lineToParse . split (V") ; 

Song  nextSong  = now  Song (tokens [0] , tokens [1]  , tokens [2] , tokens [3]); 
songList. add (nextSong) ; 


} 
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Revisiting  the  sort!)  method 


So  here  we  are,  trying  to  read  the  sort()  method  docs  to  find 
out  why  it  was  OK  to  sort  a list  of  Strings,  but  not  a 
list  of  Song  objects,  And  it  looks  like  the  answer  is...  - 


The  sort()  method  can  take  only  lists 
of  Comparable  objects. 

Song  is  NOT  a subtype  of 
Comparable,  so  you  cannot  sort() 
the  list  of  Songs. 


At  least  not  yet... 


public  static  <T  extends  Comparable<?  super  T»  void  sort(List<T>  list) 


This  says  “Whatever  'T'^is  must 

be  of  type  Comparable-’ 


%»ore  this  part  for  how.  But 
iV  you  dan't  it  jurt 
tta-t  iHe  type  parameter  -for 
Comparable  must  be  of  type  T 
or  one  of  T's  iupcrtypes.) 


v/ou  c-drt  paw  w only  a L^st  (<*■ 

subtype  of  list  like  /WayLtst) 
tKat  us^  a parameteri^d  type 
that  “extends  Comparable  ■ 


Char Sequence 
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In  generics,  "extends"  weans 
"extends  or  implewents" 


The  Java  engineers  had  to  give  you  a way  to  put  a constraint 
on  a parameterized  type,  so  that  you  can  restrict  it  to,  say,  only 
subclasses  of  Animal.  But  you  also  need  to  constrain  a type  to 
allow  only  classes  that  implement  a particular  interface.  So 
here’s  a situation  where  we  need  one  kind  of  syntax  to  work 
for  both  situations — inheritance  and  implementation.  In  other 
words,  that  works  for  both  extends  and  implements. 

And  the  winning  word  was...  extends . But  it  really  means  “is-a”, 
and  works  regardless  of  whether  the  type  on  the  right  is  an 
interface  or  a class. 


In  generics,  the  keyword 
“extends”  really  means  “is-a”, 
and  works  for  BOTH  classes 
and  interfaces. 


Comparable  is  a*  m-tev-fade,  50  ^1S  , 

R6AUV  reads,  "T  must  be  a %e  that 
implements  tbe  Comparable  mter+ate  • 

~T 

public  static  <T  extends  Comparable<?  super 


T 

It  does*  £ wetter  whether  tke  tVmg  o*  the  right  is 
a t\a$$  or  interne...  you  still  say  ue*te*dsw. 


T»  void  sort(List<T>  list) 


Why  didn't  they  just  make  a new  keyword,"is"? 


A. 

Jr\ - Adding  a new  keyword  to  the  language  is  a REALLY  big  deal  because 
it  risks  breaking  Java  code  you  wrote  in  an  earlier  version. Think  about 
it — you  might  be  using  a variable  "is"  (which  we  do  use  in  this  book  to  repre- 
sent input  streams).  And  since  you're  not  allowed  to  use  keywords  as  identi- 
fiers in  your  code,  that  means  any  earlier  code  that  used  the  keyword  before 
it  was  a reserved  word,  would  break.  So  whenever  there's  a chance  for  the 
Sun  engineers  to  reuse  an  existing  keyword,  as  they  did  here  with  "extends" 
they'll  usually  choose  that.  But  sometimes  they  don't  have  a choice... 

A few  (very  few)  new  keywords  have  been  added  to  the  language,  such 
as  assert  in  Java  1 .4  and  enum  in  Java  5.0  (we  look  at  enum  in  the  appen- 
dix). And  this  does  break  people's  code,  however  you  sometimes  have  the 
option  of  compiling  and  running  a newer  version  of  Java  so  that  it  behaves 
as  though  it  were  an  older  one.  You  do  this  by  passing  a special  flag  to  the 
compiler  or  JVM  at  the  command-line,  that  says, "Yeah,  yeah,  I KNOW  this  is 
Java  1 .4,  but  please  pretend  it's  really  1 .3,  because  I'm  using  a variable  in  my 
code  named  assert  that  I wrote  back  when  you  guys  said  it  would  OK!#$%" 

(To  see  if  you  have  a flag  available,  type  javac  (for  the  compiler)  or  java  (for 
the  JVM)  at  the  command-line,  without  anything  else  after  it,  and  you  should 
see  a list  of  available  options.  You'll  learn  more  about  these  flags  in  the  chap- 
ter on  deployment.) 
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Finally  we  know  what's  wrong... 

The  Song  class  needs  to  implement  Comparable 


We  can  pass  the  ArrayList<Soog>  to  the  sort()  method  onJy  if  the 
Song  class  implements  Comparable,  since  that's  the  way  the  son() 
method  was  declared.  A quick  check  of  the  API  docs  shows  the 
Comparable  interface  is  really  simple,  with  only  one  method  to 
implement: 


java.Iang.Comparable 


And  the  method  documentation  for  compareTo()  says 

^ Returns:  Ik 

a negative  integer,  zero,  or  a 
positive  integer  as  this  object 
la  less  than,  ecjual  to,  or  greater  I 
than  the  specified  object. 


It  looks  like  the  compareToO  method  will  be  called  on  one 
Song  object,  passing  that  Song  a reference  to  a different 
Song.  The  Song  running  the  compareTo()  method  has  to 
figure  out  if  the  Song  it  was  passed  should  be  sorted  higher, 
lower,  or  the  same  in  the  list 

Your  big  job  now  is  to  decide  what  makes  one  song  greater 
than  another,  and  then  implement  the  compareToO  method 
to  reflect  that  A negative  number  (any  negative  number) 
means  the  Song  you  were  passed  is  greater  than  the  Song 
running  the  method.  Returning  a positive  number  says 
that  the  Song  running  the  method  is  greater  than  the  Song 
passed  to  the  compareToQ  method.  Returning  zero  means 
the  Songs  are  equal  (at  least  for  the  purpose  of  sorting...  it 
doesn't  necessarily  mean  they're  the  same  object).  You  might, 
for  example,  have  two  Songs  with  the  same  title, 

(Which  brings  up  a whole  different  can  of  worms  we'll  look 
at  later...) 


The  big  question  is:  what 
makes  one  song  less  than, 
equal  to,  or  greater  than 
another  song? 

You  can’t  implement  the 
Comparable  Interface  until  you 
make  that  decision. 


|— parpen  your  pencil 


Write  in  your  idea  and  pseudo  code  (or 
better,  REAL  code)  for  Implementing  the 
compareToO  method  In  a way  that  will 
sort()  the  Song  objects  by  title. 

Hint;  if  you're  on  the  right  track,  it  should 
take  less  than  3 lines  of  code! 
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The  new,  improved,  comparable  Song  class 


We  decided  we  want  to  sort  by  tide,  so  we  implement  the  eompareToO 
method  to  compare  the  tide  of  the  Song  passed  to  the  method  against 
the  title  of  the  song  on  which  the  eompareToO  method  was  invoked. 
In  other  words,  the  song  running  the  method  has  to  decide  how  its 
dde  compares  to  the  title  of  the  method  parameter 


Hrmnirr..  we  know  that  the  String  class  must  know  about  alphabetical 
order,  because  the  sort()  method  worked  on  a list  of  Strings.  We  know 
String  has  a eompareToO  method,  so  why  not  just  call  it?  That  way  we 
can  simply  let  one  tide  String  compare  itself  to  another,  and  we  don’t 
have  to  write  the  comparing/alphabetizing  algorithm! 

Usually  these  match- -weVe  specify^  the  type  that 

^ tv,£  implement^  6l*i  Mr  be  spared  against, 

class  Song  implements  Comparable<Song>  { This  means  that  oWt-b  can  be 

String  title;  ofker  object*,  W tne  purpose  * *0 

String  artist; 

String  rating;  ^0  mtthod  sends  a Sanj  to  CompaveToO 

S tring  bpm;  f ^ ^ ^ ^ ^ tompares  to  the  So*}  or, 

which  the  method  was  invoked- 

public  int  compareTo (Song  a)  { 

return  title . compareTo  (s . getTitle  () ) ; ^ j^t  pass  t>i<  work 

v ^ o»  to  the  title  Sbri«5  objects, 

since  we  know  Sti-mjs  have  a 

Song  (String  t,  String  a,  String  r,  String  b)  ( iompdveToO  method 

title  = t; 
artist  *=  a; 
rating  = r; 
bpm  = b ; 

} 


public  String  getTitle (>  { 
return  title; 

) 

public  String  getArtist()  { 
return  artist; 

\ 

public  String  getRating()  { 
return  rating; 

) 

public  String  getBpm()  { 
return  bpm; 

> 

public  String  toStringO  { 
return  title; 

) 

) 
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1 iL  C -i-i  J.:jO  hvj  + ,rlf.. 


| R»  EtfH  Window  ~ 


%java  Jukebox3 

(Pink  Moon,  Somersault,  Shiva  Moon,  Circles,  Deep 
Channel,  Passenger,  Listen] 

[Circles,  Deep  Channel,  Listen,  Passenger,  Pink 
Moon,  Shiva  Moon,  Somersault] 
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We  can  sort  the  list,  but... 

There's  a new  problem — Lou  wants  two  different  views  of  the  song  list, 
one  by  song  title  and  one  by  arristi 

But  when  you  make  a collection  element  comparable  (by  having  it 
implement  Comparable) , you  get  only  one  chance  to  implement  the 
compareTo()  method.  So  what  can  you  do? 

The  horrible  way  would  be  to  use  a flag  variable  in  the  Song  class, 
and  then  do  an  if  test  in  compareToQ  and  give  a different  result 
depending  on  whether  the  flag  is  set  to  use  title  or  artist  for  the 
comparison. 

But  thats  an  awful  and  brittle  solution,  and  there’s  something  much 
better.  Something  built  into  the  API  forjust  this  purpose — when  you 
want  to  sort  the  same  thing  in  more  than  one  way 

Look  at  the  Collections  class  API  again.  There’s  a 
second  sortQ  method — and  It  takes  a Comparator. 


That's  not  good  enough. 
Sometimes  I want  it  to  sort 
by  artist  instead  of  title. 


C> 

o 


Collections  (Java  2 Platform  5E  5.0) 

l file:///Users/kathy/Public/docs/apf/lndex.html 

WQr  Google  J 

s Jellyvision.  Inc.  Collections  ...form  St  5.0)  Caffeinated  d grain  Day  Brandi  Noise 

Diva  Marketing  » 

static 
<Xy V>  Map<K,V> 


,r.  owt  ^ 


BlugletonHapfK  key,  V value) 

Returns  an  immutable  map,  mapping  only  the 
specified  key  to  tbe  specified  value. 

aort(Li3t<T>  list) 

^per  void  Sorts  *e  sPec^e<5  ^ mlD  ascending  order, 
v according  to  the  natural  ordering  of  its  elements. 

super 


0 
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Using  a custom  Comparator 

An  element  in  a list  can  compare  itself  to  another  of 
its  own  type  in  only  one  way,  using  its  compareTo() 
method.  But  a Comparator  is  external  to  the  element 
type  you're  comparing — it's  a separate  class.  So  you  can 
make  as  many  of  these  as  you  like!  Want  to  compare 
songs  by  artist?  Make  an  ArtistComparator.  Sort  by  beats 
per  minute?  Make  a BPMComparaton 

Then  all  you  need  to  do  is  call  the  overloaded  sort() 
method  that  takes  the  List  and  the  Comparator  that  will 
help  the  sort()  method  put  things  in  order 

The  sort()  method  that  takes  a Comparator  will  use  the 
Comparator  instead  of  the  element's  own  compareTo() 
method,  when  it  puts  the  elements  in  order  In  other 
words,  if  your  sort()  method  gets  a Comparator,  it  won't 
even  callxhe  compareTo()  method  of  the  elements 
in  the  list  The  sort()  method  will  instead  invoke  the 
compare()  method  on  the  Comparator. 

So,  the  rules  are: 


java.util.Comparator 


If  you  pass  a Comparator  to  the 
SortO  method,  ike  sort  order  is 
determined  hy  the  Comparator 
rather  than  the  element's  own 
compareTo()  method. 


> Invoking  the  one-argument  sort(List  o)  method 
means  the  list  element’s  compareToO  method 
determines  the  order.  So  the  elements  In  the  list 
MUST  Implement  the  Comparable  interface. 


> Invoking  sort(Llst  o,  Comparator  c)  means  the 
list  element’s  compareToO  method  will  NOT  be 
called,  and  the  Comparator’s  compareO  method 
will  be  used  Instead.  That  means  the  elements 
In  the  list  do  NOT  need  to  Implement  the 
Comparable  Interface. 


So  does  this  mean  that  if  you  have  a class  that 
doesn't  Implement  Comparable,  and  you  don't  have  the 
source  code,  you  couJd  still  put  the  things  In  order  by 
creating  a Comparator? 

A- 

*1*  That's  right.The  other  option  (if  it's  possible)  would  be 
to  subclass  the  element  and  make  the  subclass  implement 
Comparable. 


S'/  But  why  doesn't  every  class  Implement  Comparable? 

A- 

Do  you  really  believe  that  everything  can  be  ordered? 

If  you  have  element  types  that  Just  don't  lend  themselves  to 
any  kind  of  natural  ordering,  then  you'd  be  misleading  other 
programmers  If  you  implement  Comparable.  And  you  aren't 
taking  a huge  risk  by  not  Implementing  Comparable,  since 
a programmer  can  compare  anything  in  any  way  that  he 
chooses  using  his  own  custom  Comparator. 
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Updating  the  Jukebox  to  use  a Comparator 

We  did  three  new  things  in  this  code: 

1)  Created  an  inner  class  that  implements  Comparator  (and  thus  the  compare() 
method  that  does  the  work  previously  done  by  compareTb( )). 

2)  Made  an  instance  of  the  Comparator  inner  class. 

3)  Called  the  overloaded  sort()  method,  giving  it  both  the  song  list  and  the 
instance  of  the  Comparator  inner  class. 

Note:  we  also  updated  the  Song  class  to$tring()  method  to  print  both  the  song 
title  and  the  artist  (It  prints  tide:  artist  regardless  of  how  the  list  is  sorted.) 


import  java . util . * ; 
import  java.io.*; 


public  class  JuXeboxS  { 

Array Li st<Song>  songList  = new  ArrayList<Song> O ; 3 «*/  tlai*  that  imylen'Cnts 

public  static  void  main  (String  []  args)  { Comparator  that  its  bftt 

new  Jukebox 5 ( ) . go  < ) ; ?3rLchtr  matter  the  ty?<  weVe  w* 

] to  £M»ra re-\»  •this  case  objetts  ) 


class  Artis tConpare  implements  Comparator<Song>  { 
public  int  compare  (Song  one,  Song  two)  { 

return  one . getArtist () .compareTo (two.getArtist () ) 


) 


) 


TV,.  » sti (tkt 


public  void  go()  ( 
getSongs  ( ) 

System .out .println  (songList) ; 
Collections , sort (songList) ; 
System . out . println (songList) ; 


Alake  Zti  inrtatiCe 

Comparator  mncv  claw- 


Artist Compare  artistCompare  = new  ArtistCompare ( ) 

Collections. sort (songList,  art is tConpare) ; 

tetoi**** 


System. out .println (songList) 


t*the  rxw 


void  getSongs 0 { 

//  I/O  code  hare 

1 

void  addSong (String  lineToParse)  { 

f ) parse  line  and  add  to  song  list 

} 


Note:  weJve  made  sort-by-title  the  default  sort,  by 
keeping  thecompareToO  method  In  Song  use  the 
titles.  But  another  way  to  design  this  would  be  to 
Implement  both  the  title  sorting  and  artist  sorting  as 
inner  Comparator  classes, and  not  have  Song  implement 
Comparable  at  all.That  means  weJd  always  use  the  two- 
arg  version  of  Collectlons.sortO- 
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collections  exercise 


import  ; 

public  class  SortMountains  { 

LinkedList mtn  = new  LinkedList {); 


class  NameCompare  { 

public  int  compare (Mountain  one,  Mountain  two)  { 

return ; 

) 

> 

class  HeightCompare  { 

public  int  compare (Mountain  one,  Mountain  two)  { 

return  ( ) ; 

> 

> 

public  static  void  main (String  []  args)  { 
new  SortMountain ( ) - go ( ) ; 

> 

public  void  go()  { 

mtn.add(new  Mountain ( "Longs" , 14255)); 
mtn. add ( new  Mountain ( "Elbert" , 14433 ) ) ; 
mtn.add(new  Mountain ( "Maroon" , 14156)); 
mtn.add(new  Mountain( "Castle" , 14265 ) ) ; 

System. out. println( "as  entered t\n"  + mtn); 

MameCompare  nc  = new  NameCompare( ) ; 


System. out .println( "by  name:\n"  + mtn); 
HeightCompare  he  = new  HeightCompare ( ) ; 


Reverse  Engineer 

Assume  this  code  exists  in 
a Single  file.  Your  job  is 
to  fifl  in  the  blanks  So  the 
the  program  will  create  the 
outfit  shown. 


Note:  answers  are  at  the  end  of 
the  chapter. 


System. out. println( "by  heighten"  + mtn); 

} 

> 

class  Mountain  { 


{ 


) 

{ 


> 

} 


Output: 

l-^TTdh  Vtflndow~Heir^iiisOna^For8ob 


%java  SortMountains 
as  entered: 

[Longs  14255,  Elbert  14433,  Maroon  14156,  Castle  14265] 
by  name: 

[Castle  14265,  Elbert  14433,  Longs  14255,  Maroon  14156) 
by  height: 

(Elbert  14433,  Castle  14265,  Longs  14255,  Maroon  14156] 
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^harp«i  your  pencil  pll-fa^Ha^ 

For  each  of  the  questions  below,  fill  in  the  blank 
with  one  of  the  words  from  the  "possible  answers" 
list,  to  correctly  answer  the  question.  Answers  are 
at  the  end  of  the  chapter. 

Possible  Answers: 

Comparator, 

Comparable, 
compareTo( ), 
compare( ), 
yes, 
no 

Given  the  following  compilable  Statement- 

Collections,  sort  (myArrayList)  ; 

1.  What  must  the  class  of  the  objects  stored  in  myArrayList  implement? 

2.  What  method  must  the  class  of  the  objects  stored  in  myArrayList  implement? 

3.  Can  the  class  of  the  objects  stored  in  myArrayList  implement  both 
Comparator  AND  Comparable? 


Given  the  following  compilable  statement: 

Collections . sort (myArrayList,  myCompare) ; 

4.  Can  the  class  of  the  objects  stored  in  myArrayList  implement  Comparable? 

5.  Can  the  class  of  the  objects  stored  in  myArrayList  implement  Comparator? 

6.  Must  the  class  of  the  objects  stored  in  myArrayList  implement  Comparable? 

7.  Must  the  class  of  the  objects  stored  in  myArrayList  implement  Comparator? 

8.  What  must  the  class  of  the  myCompare  object  implement? 

9.  What  method  must  the  class  of  the  myCompare  object  implement? 


dealing  with  duplicates 

Uh-oh.  The  sorting  all  works,  but  now  we  have  duplicates... 

The  sorting  works  great,  now  we  know  how  to  son  on  both  title  (using  the  Song  object's 
compareToQ  method)  and  artist  (using  the  Comparator's  compare()  method).  But  there's 
a new  problem  we  didn't  notice  with  a test  sample  of  the  jukebox  text  file — the  sorted  list 
contains  duplicates. 

It  appears  that  the  diner  jukeboxjust  keeps  writing  to  the  file  regardless  of  whether  the 
same  song  has  already  been  played  (and  thus  written)  to  the  text  file.  The  SongListMore.txt 
jukebox  text  file  is  a complete  record  of  every  song  that  was  played,  and  might  contain  the 
same  song  multiple  times. 


| FIH  salt  Wfodow  Hdp  T&cM**yNO»)a  | 


%java  Jukebox4 

[Pink  Moon:  Nick  Drake,  Somersault:  Zero  7,  Shiva  Moon:  Prem 
Joshua,  Circles:  BT,  Deep  Channel:  Afro  Celts,  Passenger: 
Headmix,  Listen:  Tahiti  80,  Listen:  Tahiti  80,  Listen:  Tahiti 
80,  Circles:  BT] 

[Circles:  BT,  Circles:  BT,  Deep  Channel:  Afro  Celts,  Listen: 
Tahiti  80,  Listen:  Tahiti  80,  Listen:  Tahiti  80,  Passenger: 
Headmix,  Pink  Moon:  Nick  Drake,  Shiva  Moon:  Prem  Joshua, 
Somersault:  Zero  7] 

[Deep  Channel:  Afro  Celts,  Circles:  BT,  Circles:  BT,  Passenger: 
Headmix,  Pink  Moon:  Nick  Drake,  Shiva  Moon:  Prem  Joshua,  Listen: 
Tahiti  80,  Listen:  Tahiti  80,  Listen:  Tahiti  80,  Somersault: 

Zero  7] 


- Bfrf arc 


i be 
artist 


SongUs+More . txt 


Pink  Moon/Nick  Drake/S/80 
Somersault/Zero  7/4/84 
Shiva  Moon/Prem  Joshua/6/120 
Circles /BT/5/110 
Deep  Channel/Afro  Celts/4/120 
Passenger/Headmix/4/100 
Listen/Tahiti  80/5/90 
Listen /Tahiti  80/5/90 
Listen /Tahiti  80/5/90 
Circles/BT/5/U0 


W a, 

pfc M i,  JdcVt  r Tw'ne  is  ,h 

w & i, 
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collections  with  generics 


We  need  a Set  instead  of  a Ust 

From  the  Collection  API,  we  find  three  main  interfaces,  List,  Set,  and 
Map.  ArrayList  is  a List,  but  it  looks  like  Set  is  exacdy  what  we  need. 


>-  LIST  ■ when  sequence  matters 
Collections  that  know  about  Index  position. 

Lists  know  where  something  is  in  the  list  You 
can  have  more  than  one  element  referencing 
the  same  object 


V SET  - when  uniqueness  matters 
Collections  that  do  not  allow  duplicates. 

Sets  know  whether  something  is  already  in  the  collection. 
You  can  never  have  more  than  one  element  referencing 
the  same  object  (or  more  than  one  element  referencing 
two  objects  that  are  considered  equal— well  look  at  what 
object  equality  means  in  a moment). 


duplitaf** 


Set 


> MAP  ■ when  finding  something  by  key  matters 

Collections  that  use  key-value  pairs. 

Maps  know  the  value  associated  with  a given  key.  You 
can  have  two  keys  that  reference  the  same  value,  but  you 
cannot  have  duplicate  keys.  Although  keys  are  typically 
String  names  (so  that  you  can  make  name/value  property 
lists,  for  example),  a key  can  be  any  object. 


OK.  Wt  NO  duplitaU 


Map 
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the  collections  API 


The  Collection  API  (part  of  it) 


Notice  that  the  Map  interface  doesn't 
actually  extend  the  Collection  interface, 
but  Map  is  still  considered  pan  of  the 
“Collection  Framework”  (also  known 


Mays  don't  extend  from 
java  util  Col  lection,  Wt 
xheyVc  still  Considered 
to  be  part  of  the 
Collections  framework 
in  Java-  £o  a Map  « 
still  veferved  to  as  a 
Colledtion. 
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collections  with  generics 


Using  a HashSet  instead  of  ArrayUst 

We  added  on  to  the  Jukebox  to  put  the  songs  in  a HashSet.  (Note:  we  left  out  some 
of  the  Jukebox  code,  but  you  can  copy  it  from  earlier  versions.  And  to  make  it  easier 
to  read  the  output,  we  went  back  to  the  earlier  version  of  the  Song's  toStringO 
method,  so  that  it  prints  only  the  title  instead  of  tide  and  artist.) 


import  java. util ; 
import  java . io . 


public  class  Jukebox 6 | 

ArrayList<$ong>  songList  = new  ArrayList<Song>  ( ) ; 
/ / main  method  etc. 


. We  didn't  ytSonyO,  M it  still  p«*t»  the  sory  a*  ArrtyUst 


Here  vie  trea-te  3 Ha^kScb 
parameterized  to  bold  £0*3^ 


public  void  gof)  f 
getSongs  ( ) ; 4r — 

System. out . print In < songList 1 ; 

Collections . sort (songList ) ; 

System. out . println (songList) ; 

HashSet<Song>  songSet  = new  HashSet<Song> () ; 
songSet.  addAll  (songList)  / ^ — HaskStt 

System. out, println (songSet) 


) 

//  getSongs ()  and  addSong ( ] methods 


VC  "‘Wll°  ■“‘‘“J  ttrt  u» 

“ , I tt,e  **  >(  « *£&  «K 

3 °*c  at  a W (except  mwti, 


I pa*  Edli  Window  Hera  GaifietiarMmit 

1 

% java  Jukebox€ 

[Pink  Moon,  Somersault,  Shiva  Moon,  Circles,  Deep  Channel, 
I Passenger,  Listen,  Listen,  Listen,  Circles] 

(Circles,  Circles,  Deep  Channel,  Listen,  Listen, 
Passenger,  Pink  Moon,  Shiva  Moon,  Somersault] 

Listen, 

[Pink  Moon,  Listen,  Shiva  Moon,  Circles,  Listen, 
Passenger,  Circles,  Listen,  Somersault] 

Deep  Channel, 

TKt  Set  didn't  help// 

still  have  all  the  duplicates./ 


(And  it  lost  its  sort  «*■<*«■ 
when  we  put  the  list  into  a 
HashSet,  but  we’ll  wo *ry  about 
that  one  later...) 


- Be-f <*-e  swti^j 
the  /b-rayList. 


_ A-fte*-  sorting 
the  AirrayLiit 
(by  title)- 

A-fter  putting  it 
into  a HashSet, 
and  pvintin^  the 
HashSet  (we  didn't 
till  sortO  ae^ain). 
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object  equality 


What  wakes  two  objects  equal? 

First,  we  have  to  ask — what  makes  two  Song  references 
duplicates?  They  must  be  considered  equal.  Is  it  simply  two 
references  to  the  very  same  object,  or  is  it  two  separate  objects 
that  both  have  the  same  lillet 

This  brings  up  a key  issue:  reference  equality  vs,  object  equality. 

> Reference  equality 

Two  references,  one  object  on  the  heap, 

Two  references  that  refer  to  the  same  object  on 
the  heap  are  equal.  Period.  If  you  call  the  hashCodefl  method  on 
both  references,  you'll  get  the  same  result  If  you  don't  override  the 
hashCode()  method,  the  default  behavior  (remember,  you  inherited 
this  from  class  Object)  is  that  each  object  will  get  a unique  number 
(most  versions  of  Java  assign  a hashcode  based  on  the  objects 
memory  address  on  the  heap,  so  no  two  objects  Mil  have  the  same 
hashcode). 

If  you  want  to  know  if  two  references  are  realty  referring  to  the  same 
object,  use  the  ==  operator,  which  (remember)  compares  the  bits  in 
the  variables,  If  both  references  point  to  the  same  object,  the  bits  will 
be  Identical. 


If  two  objects  foo  and  bar  are 
equal,  foo.equals(bar j must  be 
true,  and  both  foo  and  bar  must 
return  the  same  value  from 
hashCorfeO'  For  a Set  to  treat 
two  objects  as  duplicates,  you 
must  override  the  hashCode() 
and  equatsf)  methods  inherited 
from  class  Object,  so  that  you 
can  make  two  different  objects 
be  viewed  as  equal* 


Song 

if  {foo  ™ bar)  { 

I f both  references  are  referring 
//  to  the  same  object  on  the  heap 

> 


> Object  equality 

Two  references,  two  objects  on  the  heap,  but 
the  objects  are  considered  meaningfully  equivalent 

If  you  want  to  treat  two  different  Song  objects  as  equal  (for 
example  if  you  decided  that  two  Songs  are  the  same  if  they  have 
matching  title  variables),  you  must  override  both  the  hashCodeO 
and  equalsO  methods  inherited  from  class  Object 

As  we  said  above,  if  you  don't  override  hashCode(),  the  default 
behavior  (from  Object)  is  to  give  each  object  a unique  hashcode 
value.  So  you  must  override  hashCodeO  to  be  sure  that  two 
equivalent  objects  return  the  same  hashcode.  But  you  must  also 
override  equalsO  so  that  if  you  call  it  on  either  object,  passing  in 
the  other  object,  always  returns  true. 

if  ( foe. equals (bar) 


//  both  references  are  referring  to  either  a 


//  a single  object,  or  to  two  objects  that  are  equal 


) 
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collections  with  generics 


How  a HashSet  cheeks  for  duplicates:  hashCodel)  and  equals!) 


When  you  put  an  object  into  a Hashset,  it  uses  the 
object's  hashcode  value  to  determine  where  to  put 
the  object  in  the  Set.  But  it  also  compares  the  object's 
hashcode  to  the  hashcode  of  all  the  other  objects  in 
the  HashSet,  and  if  there's  no  matching  hashcode, 
the  HashSet  assumes  that  this  new  object  is  not  a 
duplicate. 

In  other  words,  if  the  hashcodes  are  different,  the 
HashSet  assumes  there's  no  way  the  objects  can  be 
equail 

So  you  must  override  hashCode ()  to  make  sure  the 
objects  have  the  same  value. 

But  two  objects  with  the  same  hashCode ()  might  not 


HashSet  finds  a matching  hashcode  for  two  objects — 
one  you're  inserting  and  one  already  in  the  set — the 
HashSet  will  then  call  one  of  the  object's  equals() 
methods  to  see  if  these  hashcode-matched  objects 
really  are  equal. 

And  if  they're  equal,  the  HashSet  knows  that  the 
object  you're  attempting  to  add  is  a duplicate  of 
something  in  the  Set,  so  the  add  doesn't  happen. 

You  don't  get  an  exception,  but  the  HashSet's  add() 
method  returns  a boolean  to  tell  you  {if  you  care) 
whether  the  new  object  was  added.  So  if  the  add() 
method  returns  false,  you  know  the  new  object  was  a 
duplicate  of  something  already  in  the  set. 
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overriding  hashCode()  and  equalsQ 

The  Song  class  with  overridden 
hashCodeO  and  equals!) 


class  Song  implements  Comparable<Song> { 
String  title; 

String  artist; 


String  rating; 
String  bpm; 


tw  a 


t 


public  boolean  equals (Object  aSong) 

Song  s = (Song)  aSong; 

return  getTitle() . equals (s . getTi tie () ) 

) 


^ atf AT  — •»  ■»  • ^ 

*w,or 


public  int  hashCodeO  { Sa*e  deil  ho-<...  £h<  ,(i  . 

return  title  .hashCode  ()  hashCodeO  3 has  ovcv-srid^^ 

, * ll-  . . * .. 10  Y<*  iui+  1l 


} 


public  int  compareTo (Song  s)  f 

return  title . compareTo (s . getTi tie ( ) ) ; 


hashCodeO  0*  'r£su^  <►£ 


) 


Song(String  t,  String  a/ 
title  = t; 
artist  = a; 
rating  = r; 
bpm  = b; 

} 

public  String  getTir.leO 
return  title; 

} 

public  String  getArtistO 
return  artist; 

} 

public  String  getRatingO 
return  rating; 

} 

public  String  getBpmO  { 
return  bpm; 

) 

public  String  toStringO  { 
return  title; 

) 


String  r,  String  b)  f 

Now  it  works f No  duplicate  when  we 
priht  oot  the  HashSet  Bui  w e didn't 
6dll  sort/)  d^dinj  3nd  when  we  put 
the  A^^^vList  into  the  hbshSet,  the 

^ BashSet  flidn  t preserve  the  sort  order. 

File  Edit  Window  Help  ft«oo(Wtodows 


%java  Jukebox6 

[Pink  Moon,  Somersault,  Shiva  Moon,  Circles, 
Deep  Channel,  Passenger,  Listen,  Listen, 
Listen,  Circles] 

[Circles,  Circles,  Deep  Channel,  Listen, 
Listen,  Listen,  Passenger,  Pink  Moon,  Shiva 
Moon , Somers aul t ] 

[Pink  Moon,  Listen,  Shiva  Moon,  Circles, 
Deep  Channel,  Passenger,  Somersault] 
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collections  with  generics 


Java  Object  Law  For  HashCode() 
and  equals() 


The  API  docs  for  class  Object  state  the 
rules  you  MUST  follow; 


If  two  objects  are  equal,  they  MUST 
have  matching  hashcodes. 


If  two  objects  are  equal,  calling 
equals()  on  either  object  MUST  return 
true.  In  other  words,  if  (a.equals(b))  then 
(b-equals(a)). 


If  two  objects  have  the  same  hashcode 
value,  they  are  NOT  required  to  be  equal. 
But  if  they’re  equal,  they  MUST  have  the 
same  hashcode  value. 


So,  if  you  override  equals(),  you  MUST 
override  hashCode(). 


The  default  behavior  of  hashCode() 
is  to  generate  a unique  integer  for  each 
object  on  the  heap.  So  if  you  don't  override 
hashCode()  in  a class,  no  two  objects  of 
that  type  can  EVER  be  considered  equal. 


The  default  behavior  of  equal$()  is  to 
do  an  =s  comparison.  In  other  words,  to 
test  whether  the  two  references  refer  to  a 
single  object  on  the  heap.  So  if  you  don't 
override  equals()  in  a class,  no  two  objects 
can  EVER  be  considered  equal  since 
references  to  two  different  objects  will 
always  contain  a different  bit  pattern. 

a.equals(b)  must  also  mean  that 
a.hashCod&()  ==  b*hashCode() 

But  a.hashCodef)  ==  b.hashCodef) 
does  NOT  have  to  mean  a.equals(b) 


• How  come  hashcodes  can  be  the  same 
even  If  objects  aren't  equal? 

A. 

r\*  HashSets  use  hashcodes  to  store  the  ele- 
ments in  a way  that  makes  it  much  faster  to  access. 
If  you  try  to  find  an  object  in  an  ArrayList  by  giving 
the  ArrayList  a copy  of  the  object  (as  opposed  to 
an  index  value),  the  ArrayList  has  to  start  searching 
from  the  beginning,  looking  at  each  element  in 
the  list  to  see  if  it  matches.  But  a HashSet  can  find 
an  object  much  more  quickly,  because  it  uses  the 
hashcode  as  a kind  of  label  on  the  "bucket"  where 
It  stored  the  element.  So  if  you  say, "I  want  you 
to  find  an  object  in  the  set  that's  exactly  like  this 
one..."  the  HashSet  gets  the  hashcode  value  from 
the  copy  of  the  Song  you  give  it  (say,  742),  and 
then  the  HashSet  says/Oh,  I know  exactly  where 
the  object  with  hashcode  #742  is  stored..."  and  it 
goes  right  to  the  #742  bucket. 

This  isn't  the  whole  story  you  get  in  a computer 
science  class,  but  it's  enough  for  you  to  use  Hash- 
Sets  effectively.  In  reality,  developing  a good  hash- 
code  algorithm  is  the  subject  of  many  a PhD  thesis, 
and  more  than  we  want  to  cover  In  this  book. 

The  point  is  that  hashcodes  can  be  the  same 
without  necessarily  guaranteeing  that  the  objects 
are  equal,  because  the'hashing  algorithm"  used  In 
the  hashCodeO  method  might  happen  to  return 
the  same  value  for  multiple  objects.  And  yes,  that 
means  that  multiple  objects  would  all  land  in  the 
same  bucket  in  the  HashSet  (because  each  bucket 
represents  a single  hashcode  value),  but  that's  not 
the  end  of  the  world.  It  might  mean  that  the  Hash- 
Set  is  just  a little  less  efficient  (or  that  it's  filled 
with  an  extremely  large  number  of  elements),  but 
if  the  HashSet  finds  more  than  one  object  in  the 
same  hashcode  bucket,  the  HashSet  will  simply 
use  the  equalsO  method  to  see  If  there's  a perfect 
match,  in  other  words,  hashcode  values  are  some- 
times used  to  narrow  down  the  search,  but  to  find 
the  one  exact  match,  the  HashSet  still  has  to  take 
all  the  objects  in  that  one  bucket  (the  bucket  for 
all  objects  with  the  same  hashcode)  and  then  call 
equalsO  on  them  to  see  if  the  object  it's  looking  for 
is  In  that  bucket. 
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TreeSets  and  sorting 


And  if  we  want  the  set  to  stay 
sorted,  we've  got  TreeSet 

TreeSet  is  similar  to  HashSet  in  that  it  prevents  duplicates.  But  it  also  keeps  the  list  sorted.  It  works 
just  like  the  sort()  method  in  that  if  you  make  a TreeSet  using  the  set’s  no-arg  constructor,  the 
TreeSet  uses  each  object’s  compareToQ  method  for  the  sort.  But  you  have  the  option  of  passing 
a Comparator  to  the  TreeSet  constructor,  to  have  the  TreeSet  use  that  instead.  The  downside  to 
TreeSet  is  that  if  you  don’t  need  sorting,  you’re  still  paying  for  it  with  a small  performance  hit.  But 
you’ll  probably  find  that  the  hit  is  almost  impossible  to  notice  for  most  apps. 

import  java. util.*; 
import  j ava . io . * ; 
public  class  JukeboxS  { 

ArrayList<3ong>  songList  - new  ArrayList<Song> (} ; 
int  val; 


public  static  void  main (String [ ] args)  { 
new  Jukebox8 ( ) . go  0 ; 

} 


Me 


public  void  go()  { 
getSongs  ( ) ; 

System. out .println (songList) ; 

Collections . sort  (songList) ; 

System. out. print In (songList) ; 

TreeSet<Song>  songSet  = new  TreeSet<Song>() ; 
songSet.  addAll  (songList)  ; 

System,  out  .println  (songSet) ; e sonjs  bom  £he  HashSe-fc 

> 'OH  we  tou|d  to*  Sdded  tie 

individually  using  songSeiaddO  just 

void  getSongs  ()  { the  way  *ddcd  songs  io  tie  /WayList) 

try  { ' 

File  file  = new  File  ( "SongListMore  . txt")  ; 

BufferedReader  reader  - new  Buf feredReader  (new  FileReader  (file)  ) ; 
String  line  - null; 

while  ((line-  reader . readLine () ) !=  null)  { 

addSong (line) ; 

1 


Calv"htesTi^  ^ 


?**d  ■- » 


} catch  (Exception  ex)  { 
ex . printStackTrace ( ) ; 

} 


void  addSong (String  lineToParse)  { 

String [ ] tokens  = lineToParse . split ( "/" ) ; 

Song  nextSong  = new  Song  (tokens [ 0] , tokens [1],  tokens [2],  tokens [3]); 
songList .add (nextSong) ; 

} 

) 


8*,  W AH 
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What  you  MUST  know  about  TreeSet... 

TreeSet  looks  easy,  but  make  sure  you  really  understand  what  you  need  to 
do  to  use  it  We  thought  it  was  so  important  that  we  made  it  an  exercise  so 
you’d  have  to  think  about  it.  Do  NOT  turn  the  page  until  you’ve  done  this. 
We  mean  it. 


i^tirpen  your  pencil 


Look  at  this  code. 
Read  it  carefully,  then 
answer  the  questions 
below.  {Note:  there 
are  no  syntax  errors 
in  this  code.) 


import  java. util.*; 

public  class  TastTree  { 

public  static  void  main  (Stringd  args)  { 


new  TastTree () .go 

\ 


public 

void 

go<) 

{ 

Book 

bl  = 

new 

Book 

Book 

b2  = 

new 

Book 

Book 

b3  = 

new 

Book 

TreeSe t<Book> 

tree 

tree. add (bl)  ; 
tree . add  (b2 ) ; 
tree. add <b3)  ; 
System,  out  .println 

} 

) 

class  Book  { 

String  title; 
public  Book (String  t) 
title  = t; 

1 

> 


0 ; 

"How  Cats  Work") ; 
"Remix  your  Body")  ; 
"Finding  Emo") ; 

= new  TreeSe t<Book> ( ) ; 
tree) ; 


1).What  Is  the  result  when  you  compile  this  code? 


2).  If  It  compiles,  what  Is  the  result  when  you  run  theTestTree  class? 


3).  If  there  is  a problem  {either  compile-time  or  runtime)  with  this  code,  how  would  you  fix  It7 
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TreeSet  elements  MUST  be  comparable 

TreeSet  can’t  read  the  programmer’s  mind  to  figure  out  how  the 
object’s  should  be  sorted.  You  have  to  tell  the  TreeSet  how. 

To  use  a TreeSet,  one  of  these 
things  must  be  true: 

> The  elements  in 

the  list  must  be  of  a type  that 
implements  Comparable 

class  Book  implements  Comparable  { 

String  title; 
public  Book (String  t)  { 
title  - t; 

} 

public  int  compareTo (Object  b)  { 

Book  book  = (Book)  b; 
return  (title . compareTo (book . title) ) ; 

} 

} 


OR 

y You  use  the  TreeSet’s 
overloaded  constructor 
that  takes  a Comparator 


class  Test  { 

public  void  go()  { 

Book  bl  = new  Book ("How  Cats  Work"); 

Book  b2  = new  Book ("Remix  your  Body"); 

Book  b3  = new  Book ("Finding  Emo") ; 

BookCompare  bCompare  = new  BookCoznpare  ( ) ; 
TreeSet<Book>  tree  = new  TreeSet<Book> (bCompare) ; 

tree. add (new  Book ("How  Cats  Work"); 
tree.add(new  Book ("Finding  Emo"); 
tree.add(new  Book("Remix  your  Body"); 

System. out. println (tree)  ; 

} 1 
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TreeSet  works  a lot  like  the  sort() 
method— you  have  a choice  of  using  the 
element’s  compareTo()  method,  assuming 
the  element  type  implemented  the 
Comparable  interface,  OR  you  can  use 
a custom  Comparator  that  knows  how 
to  sort  the  elements  in  the  set.  To  use  a 
custom  Comparator,  you  call  the  TreeSet 
constructor  that  takes  a Comparator. 


public  class  BookCompare  implements  Comparator<Book>  { 
public  int  compare (Book  one.  Book  two)  { 
return  (one . title . compareTo (two . title) ) ; 


The  Book  class  on  the  previous 
page  didn’t  implement  Comparable,  so  it 
wouldn’t  work  at  runtime.  Think  about  it,  the 
poor  TreeSet’s  sole  purpose  in  life  is  to  keep 
your  elements  sorted,  and  once  again— it  had 
no  idea  how  to  sort  Book  objects!  It  doesn’t  fail 
at  compile-time,  because  the  TreeSet  add() 
method  doesn’t  take  a Comparable  type, The 
TreeSet  add()  method  takes  whatever  type 
you  used  when  you  created  the  TreeSet.  In 
other  words,  if  you  say  new  TreeSet<Book>() 
the  add()  method  is  essentially  add(Book).  And 
there’s  no  requirement  that  the  Book  class 
implement  Comparable!  But  it  fails  at  runtime 
when  you  add  the  second  element  to  the  set. 
That’s  the  first  time  the  set  tries  to  call  one  of 
the  object’s  compareTo()  methods  and...  can’t. 


collections  with  generics 


We've  seen  Lists  and  Sets,  now  we'll  use  a Map 

Lists  and  Sets  are  great,  but  sometimes  a Map  is  the  best  collection  (not  Collection 
with  a capital  “C" — remember  that  Maps  are  part  of  Java  collections  but  they  don't 
implement  the  Collection  interface). 

Imagine  you  want  a collection  that  acts  like  a property  list,  where  you  give  it  a name 
and  it  gives  you  back  the  value  associated  with  that  name.  Although  keys  will  often  be 
Strings,  they  can  be  any  Java  object  (or,  through  autoboxing,  a primitive). 


Map 


Each  element  in  a Map  is  actually 
TWO  objects — a key  and  a value. 
You  can  have  duplicate  values , but 
NOT  duplicate  keys. 


Map  example 


import  java . util . r; 
public  class  TestMap  f 

public  static  void  main  (StringH  args)  { 


*yr<  pava-eW 

0he  key  one  u the  «alue. 


1 


HashMap<Str±ng,  Integer>  scores  = nee  HaahMap<String,  Integer>(); 


scores . 
scores . 
scores . 


put ("Kathy",  42); 
put ("Bert",  343); 
put ("Skyler" , 420); 


W«p«tOi »*t*ad  addO,  a«d  now 

takes  two  dYguments  (\ct y,  value). 


of 


) 


System. out . print In (scores) 
System . out . print In {scores . 


get  ("Bert7 


Ae  jetO  »»«th«d  takes  a key,  and 
*ei'***  the  value  U this  ease,  an  jnte3eU. 


| Edit  Window  Htfp  WTiorftAjnl 


%java  TestMap 

(Skyler=420,  Bert=343,  Kathy=42) 
343 


■t"  ^ j,‘  s»«  y~  tk<  k^=,siw, 

V ( J wtad  of  tk<  Iritktt,  f jL. 
vhen  you  print  lists  and  sets. 
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Finally,  back  to  generics 

Remember  earlier  in  the  chapter  we  talked  about  how  methods 
that  take  arguments  with  generic  types  can  be.,,  weird l And  we 
mean  weird  in  the  polymorphic  sense.  If  things  start  to  feel 
strange  here,  just  keep  going — it  takes  a few  pages  to  really  tell 
the  whole  story. 

We'll  start  with  a reminder  on  how  array  arguments  work, 
polymorphically,  and  then  look  at  doing  the  same  thing  with 
generic  list s.  The  code  below  compiles  and  runs  without  errors: 

Here’s  how  It  works  with  regular  arrays : 

import  java. util.*; 

public  class  TestGenericsl  { 

public  static  void  main (String f ] args)  { 
new  TestGenericsl O -go  0 ; 

} 

public  void  go()  { 

Animal  []  animals  = (new  Dog()  , new  Cat{)  , new  Dog()  }; 

Dog[]  dogs  = {new  Dog()  , new  Dog()  , new  Dog() 

takeAnimals  (animals)  ; Declare  ^*d  treats  <3 

takeAnimals  (dogs)  ; usi*^  bo£k  "that  hold*  only  Do^s  (ike  tomyiler 

} ^ 5r>-ay  iyfts  as  ...  woiTk'-t  let  you  put  a Ca-t  in) 


If  a method  argument  is  an  array 
of  Animals,  it  will  also  take  an 
array  of  any  Animal  subtype. 

In  other  words,  if  a method  is 
declared  as: 

void  foo(Animal[]  a)  { } 

Assuming  Dog  extends  Animal, 
you  are  free  to  call  both: 

foo(anAnimalArray); 

foo(aDogArray); 


public  void  takeAniroals (Animal []  animals) 
for (Animal  a:  animals)  { 
a. eat  ()  ; 

} ^ ^ Rtmtm  bttT) 


} 


,• , 'V*  U",0HLV  a'  * lw< 

Zi  Zti  J 3 iU  u •*  v am  JL 

we  d.dhtd<.afty  Mhat  would 


A'£ryial  15  th<  taM*UaW) 
|> ™ *»  * a DotfJ, 

03  /I  Annual.  P olymorphitm  in  adtic*. 


That 


a«-ay  *i5ht  hold  both  and  Cak> 


we  ejit  it  to? 


abstract  class  Animal  { 
void  eat{)  { 

System. out .println ("animal  eating"); 

) 


) 

class  Dog  extends  Animal  ( 
void  bark ()  { } 

1 

class  Cat  extends  Animal  { 
void  meow  0 { ) 


Ut  ^'ed  da«  hi<va*-thy. 


> 
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Using  polymorphic  arguments  and  generics 

So  we  saw  how  the  whole  thing  worked  with  arrays,  but  will  it  work 
the  same  way  when  we  switch  from  an  array  to  an  ArrayList?  Sounds 
reasonable,  doesn't  it? 

First,  let’s  try  it  with  only  the  Animal  ArrayList.  We  made  just  a few 
changes  to  the  go()  method; 


Passing  In  just  ArrayUst<Anlmal> 


A simple  Change  fro»>  AhimaJfJ  to 


public  void  go()  { 

ArrayList<Animal>  animals  = new  AxrayList<Animal>() 

animals ► add (new  DogO); 


animals . add (new  Cat  () ) / 
animals . add (new  Dog() ) ; 

takeAnimals  (animals) 


Vtlu,''±b>  ldd  Te  3i  3 tiwe  i,nte  tw'*  •» 

h°^u-t  like  there  is  for  away  create. 

™Ui^Tn'Y*de,l*eri  ho*  ^ 

ble  'refe»  **  ArrayList  iwt ead  of  away. 


public  void  taheAnimals  (ArrayLis t<Animal>  animals)  ( 

for (Animal  a : animals)  { 
a.eat()  ; 


} 


) 


n>e  method  now  takes  ah  AwayList 
Jhstcad  of  ah  away,  but  everything  else  is 
the  w«e.  Remember,  that  for  loop  syntax 
works  for  both  arrays  a*d  £oll„+;,J 


Compiles  and  runs  just  fine 


f Flip  &0H  Window  Help  CtflFoodltBettar 


%java  TestGenerics2 

animal  eating 
animal  eating 
animal  eating 
animal  eating 
animal  eating 
animal  eating 
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But  will  it  work  with  ArrayUst<Pog>  f 

Because  of  polymorphism,  the  compiler  let  us  pass  a Dog  array 
to  a method  with  an  Animal  array  argument.  No  problem.  And 
an  ArrayUst<Animal>  can  be  passed  to  a method  with  an 
AnayList<Animal>  argument  So  the  big  question  is,  will  the 
ArrayList<Animal>  argument  accept  an  ArrayList<Dog>?  If  it  works 
with  arrays,  shouldn't  it  work  here  too? 

Passing  in  just  ArrayList<Dog> 


public  void  go()  ( 

Ar rayLis t<Animal>  animals  = new  ArrayList<Animal>  { ) ; 
animals . add (new  Dog{J); 
animal s . add (new  Cat{)); 
animals . add (new  Dog  0 } ; 

takeAnimals  (animals);  ^ li,e  W 

ArrayList<Dog>  dogs  = new  ArrayList<Dog>() ; 

dogs,  add  (new  DogO);  /m.l,,  . r,  a 

dogs,  add  (new  DogO);  ^ l4^  put  a £onpl<  doy  in. 

(dogs)  ; w,„  ^ thit  „ 

+V<^  a*  drt-ay  iri  yLii-t? 


public  void  takeAnimals  (ArrayLi8t<Animal>  animals)  ( 

for  (Animal  a : animals)  ( 
a . eat  ( ) ; 

} 

} 


When  we  compile  it: 


| ftfe  Edit  Window  H»tp  OmArsSnww 


%java  Test6enerics3 

TestGenerics3 . java : 21 : takeAnimals (java . util . 
ArrayList<Animal>)  in  TestGenerics3  cannot  be  applied  to 
(java. util . ArrayList<Dog>) 
takeAnimals (dogs) ; 

A 

1 error 


It  looked  so  yjj hi, 
but  went  so 
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And  Tm  supposed  to  be  OK  with  this?  That 
totally  screws  my  animal  simulation  where  the 
veterinary  program  takes  a list  of  any  type  of 
animal,  so  that  a dog  kennel  can  send  a list  of  dogs, 
and  a cot  kennel  can  send  a list  of  cats,.,  now 
you're  saying  I can't  do  that  if  I use  collections 
instead  of  arrays? 


What  could  happen  if  it  were  allowed... 

Imagine  the  compiler  let  you  get  away  with  that.  It  let  you  pass  an 
ArrayUst<Dog>  to  a method  declared  as: 

public  void  takeAnimals  (ArrayList<Animal>  animals)  ( 
for (Animal  a:  animals)  { 
a .eat  0 ; 


} 


) 


There's  nothing  in  that  method  that  boks  harmful,  right?  After  all, 
the  whole  point  of  polymorphism  is  that  anything  an  Animal  can 
do  (in  this  case,  the  eat()  method),  a Dog  can  do  as  well.  So  what's 
the  problem  with  having  the  method  cal)  eat()  on  each  of  die  Dog 
references? 

Nothing . Nothing  at  all. 

There's  nothing  wrong  with  that  code.  But  imagine  this  code  instead: 


public  void  takeAnimals  (ArrayList<Animal>  animals)  ( 

animals. add (new  Cat() ) ; 


/ikes If  We  jwt  studk  a Cat  in  vAat 
mi^Kt  be  d Doy-owly  AnrayList 


So  Lhat  s the  problem.  There’s  certainly  nothing  wrong  with  adding  a 
Cat  to  an  ArTayUst<Anjmai>l  and  that's  the  whole  point  of  having  an 
ArrayLisi  of  a supertype  like  Animal — so  that  you  can  put  all  types  of 
animals  in  a single  Animal  ArrayList, 

But  if  you  passed  a Dog  ArrayList — one  meant  to  hold  ONLY  Dogs — 
to  this  method  that  takes  an  Animal  ArrayList,  then  suddenly  you’d 
end  up  with  a Cat  in  the  Dog  list.  The  compiler  knows  that  if  it  lets 
you  pass  a Dog  ArrayList  into  the  method  like  that,  someone  could, 
at  runtime,  add  a Cat  to  your  Dog  list.  So  instead,  the  compiler  just 
won't  let  you  take  the  risk. 

If  you  declare  a method  to  take  ArrayList  <Ammal>  it  can  take  ONLY  an 
ArrayList  <Animal>r  not  Array  List  <Dog>  or  ArrayList<Cat>. 
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Wait  a minute...  if  this  is  why  they  won't  let 
you  pass  a Dog  ArrayList  into  a method  that 
takes  an  Animal  ArrayList— to  stop  you  from 
possibly  putting  a Cat  in  what  was  actually  a Dog  list, 
' then  why  does  it  work  with  arrays?  Don’t  you  have 
the  same  problem  with  arrays?  Can't  you  still  add 
o Cat  object  to  a Dog[]  ? 


Array  types  are  checked  again  at 
runtime,  but  collection  type  checks 
happen  only  when  you  compile 


Let’s  say  you  do  add  a Cat  to  an  array  declared  as  Dog[]  (an  array  dial 
was  passed  into  a method  argument  declared  as  Anima)[],  which  is  a 
perfectly  legal  assignment  for  arrays). 

public  void  go  0 { 

Dog[]  dogs  = {new  Dog()  , new  Dog()  , now  Dog()}; 
takoAnimals (dogs) ; 

) 

public  void  taJeaAn imal a (Animal  []  animals)  ( 
animals (0]  = new  Cat { ) 

1 


We  pvt  a new  Cat  into  a D©$  array.  The 
dompilei r allowed  it)  because  ft  knows  that 
you  mi<jht  have  passed  a Cat  array  or  Animal 
array  to  the  method,  SO  to  the  Compiler  it 
was  possible  that  this  was  OK- 


It  compiles,  but  when  we  run  it: 


Whew/  At  least  the 
stopped  it. 


[ File  Eclid  Wfndo#  Cs&AokSm&iw 


%java  TestGenericsl 
Exception  in  thread  "main"  java 
Cat 

at  TestGenericsl . take Animals (TestGenericsl . java : 16) 
at  TestGenericsl . go (TestGenericsl . java : 12) 
at  TestGenericsl .main (TestGenericsl. java: 5) 
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Wouldn't  it  be  dreamy  if  there  were  \ 
a way  to  still  use  polymorphic  collection 
types  as  method  arguments,  so  that  my 
veterinary  program  could  take  bog  lists 
and  Cat  lists?  That  way  I could  loop  through 
the  lists  and  call  their  immunize()  method, 
but  it  would  still  have  to  be  safe  so  that  you 
couldn't  add  a Cat  in  to  the  bog  list.  But  I 
guess  that's  just  a fantasy...  ] 


generic  wildcards 


Wildcards  to  the  rescue 


It  looks  unusual,  but  there  is  a way  to  create  a method  argument  that 
can  accept  an  ArrayList  of  any  Animal  subtype.  The  simplest  way  is  to 
use  a wildcard — added  to  the  Java  language  explicitly  for  this  reason. 


public  void  takeAnimals  (ArrayList<?  extends  Aniinal> 

for (Animal  a:  animals)  ( 
a - eat  0 ; 

1 

} 

So  now  you’re  wondering,  “What’s  the  difference?  Don’t  you  have 
the  same  problem  as  before?  The  method  above  isn’t  doing 
anything  dangerous — calling  a method  any  Animal  subtype  is 
guaranteed  to  have — but  can’t  someone  still  change  this  to  add  a 
Cat  to  the  animals  list,  even  though  it's  really  an  ArrayLisL<Dog>? 

And  since  it’s  not  checked  again  at  runtime,  how  is  this  any 
different  from  declaring  it  without  the  wildcard?* 


animals)  ( 

Remember,  ibe  keyword  "«7ft«nds” 
bet rt  rrtZrs  eiibe*-  c*icnds  OR 
irn^je^cnk  depending  on  "tbe 
type-  £«  i-t  you  want  to  take 
ah  AwayList  o£  types  that 
implement  tbe  Pet  interface) 
you'd  dedave  it  as- 

AnrayUst<?  e^tehds  Pet> 


And  you’d  be  right  for  wondering.  The  answer  is  NO.  When  you 
use  the  wildcard  <?>  in  your  declaration,  the  compiler  won't  let 
you  do  anything  that  adds  to  the  list! 


When  you  use  a wildcard  in  your  method 
argument,  the  compiler  will  STOP  you  from  doing 
anything  that  could  hurt  the  list  referenced  by  the 
method  parameter. 

You  can  still  invoke  methods  on  the  elements  in 
the  list,  but  you  cannot  add  elements  to  the  list. 

In  other  words,  you  can  do  things  with  the  list 
elements,  but  you  can’t  put  new  things  in  the  list. 
So  you’re  safe  at  runtime,  because  the  compiler 
won’t  let  you  do  anything  that  might  be  horrible  at 
runtime. 

So,  this  is  OK  inside  takcAnimals(); 


r ( ) ,' 


But  THIS  would  not  compile: 

■ 1 1 j in;.-:  ] . : . j i i i ) ■ ' ; I l ) ; 
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Alternate  syntax  for  doing  the  same  thing 

You  probably  remember  that  when  we  looked  at  the  sort()  method, 
it  used  a generic  type,  but  with  an  unusual  format  where  the  type 
parameter  was  declared  before  the  return  type.  It's  just  a different  way 
of  declaring  the  type  parameter,  but  the  results  are  the  same: 


This: 

public  <T  extends  Animal>  void  takeThing  (ArrayList<T>  list) 


Does  the  same  thing  as  this: 

public  void  takeThing  (ArrayList<?  extends  Animal>  list) 


If  they  both  do  the  same  thing,  why  would  you  use 
one  over  the  other? 

A- 

-r\-  It  all  depends  on  whether  you  want  to  use  "T" some- 
where else.  For  example,  what  if  you  want  the  method  to 
have  two  arguments—both  of  which  are  lists  of  a type  that 
extend  Animal?  In  that  case,  it's  more  efficient  to  just  declare 
the  type  parameter  once: 

public  <T  extends  Animal>  void  takeThing (ArrayList<T>  one,  ArrayList<T>  two) 
instead  of  typing: 

public  void  takeThing (ArrayList<?  extends  Animal>  one, 

ArrayList<?  extends  Animal>  two) 
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be  the  compiler  exercise 


BE  flie  compiler,  advanced 

Your  job  Is  to  play  compiler  and  determine  which  of 
these  statements  would  compile.  But  some  of  this 
code  wasn't  covered  in  the  chapter,  so  you  need  to 
work  out  the  answers  based  on  what  you  DID  learn, 
applying  the"rules"to  these  new  situations.  In 
some  cases,  you  might  have  to  guess,  but  the 
point  is  to  come  up  with  a reasonable  answer 
based  on  what  you  know  so  far. 


(Note:  assume  that  this  code  is  within  a legal  class  and 
method.) 


Compiles? 

Q ArrayList<Dog>  dogsl  = new  ArEayList<Animal>  ()  ; 

Array Lis t<Animal>  animals!  = new  ArrayList<Dog>() ; 
Q Llat<Animal>  list  ■ new  ArrayList<Animal>() ; 

Q ArrayList<Dog>  dogs  = new  ArrayList<Dog> () ; 

^ ArrayList<Animal>  animals  = dogs; 

U List<Dog>  dogList  - dogs; 

Q ArrayList<Object>  objects  = new  ArrayList<Object> () 
ListxObject^  objList  = objects; 

ArrayList<Object>  objs  = new  ArrayList<Dog>() ; 
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import  java. Util.*; 

public  class  SortMountains  { 

LinkedList<  Mountain > mtn  = new  LinkedList*  Mountain  > ( ) ; 


Solution  to “R&verae 
Engineer"  Zeroise 


class  Namecompare  implements  Comparator  < Mountain  > { 
public  int  compare (Mountain  one,  Mountain  two)  { 

return  one . name . compareTo(two . name); 

> 

> 

class  Beightcompare  implements  Comparator  <Mountain>  { 

public  int  compare (Mountain  one.  Mountain  two)  { 

return  (two. height  - one. height); 

} 

public  static  void  roain(String  []  args)  { l 

new  SortMountain ( ) >go( ) ; i* 

> 

public  void  go()  { 

mtn.add(new  Mountain ( "Longs" , 14255)); 
mtn.add(new  Mountain ( "Elbert" , 14433)); 
mtn.add(new  Mountain ( "Maroon" , 14156) ) ; 
mtn.add(new  Mountain ( "Castle" , 14265)); 

System. out .println( "as  entered:\n"  + mtn); 

NameCompare  nc  = new  NameCompare ( ) ; 

Collect  ions.  sort(mtn,  nc); 

System. out. println( "by  nametVn"  + mtn); 

HeightCompare  he  = new  Height Compare ( ) ; 

CoNectlons.sort(mtn,  he); 

System- out . println ( "by  height:\n"  + mtn); 

> 

> 


class  Mountain  { 

String  name; 
int  height; 

Mountain(String  n,  Int  h)  { 
name  = n? 
height  = h; 

> 

public  String  toString(  ) { 
return  name  * " “ * height; 

> 


Output: 

| Rle  Edit  Window  Help^ThteQne’sFofBob  j 


%java  SortMountains 
as  entered: 

[Longs  14255,  Elbert  14433,  Maroon  14156,  Castle  14265] 
by  name: 

[Castle  14265,  Elbert  14433,  Longs  14255,  Maroon  14156] 
by  height: 

[Elbert  14433,  Castle  14265,  Longs  14255,  Maroon  14156} 
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flll-in-the-blank  solution 


Excise  Solution 

Possible  Answers: 

Comparator, 
Comparable, 
compareTo( ), 
compare( ), 
yes, 
no 


Given  the  following  compilable  statement 

Collections  * sort (myArrayList) ; 


1.  What  must  the  class  of  the  objects  stored  in  myArrayList  implement?  Comparable 

2.  What  method  must  the  class  of  the  objects  stored  in  myArrayList  implement?  CompareTo(  ) 

5.  Can  the  class  of  the  objects  stored  in  myArrayList  implement  both 

Comparator  AND  Comparable?  y es 


Given  the  following  compilable  statement: 

Collections . sort (myArrayList,  myCompare) ; 

4.  Can  the  class  of  the  objects  stored  in  myArrayList  implement  Comparable?  yes 

5.  Can  the  class  of  the  objects  stored  in  myArrayList  implement  Comparator?  yes 

6.  Must  the  class  of  the  objects  stored  in  myArrayList  implement  Comparable?  no 

7.  Must  the  class  of  the  objects  stored  in  myArrayList  implement  Comparator?  MO __ 

8.  What  must  the  class  of  the  myCompare  object  implement?  Comparator 

9.  What  method  must  the  class  of  the  myCompare  object  implement?  Compare(  ) 
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BE  t(i&  cem^flex  solution 


Compiles? 

Q ArrayList<Dog>  dogsl  = new  ArrayList<Animal>() ; 

I | ArrayList<Animal>  animals!  = new  ArrayList<Dog> ()  ; 
List<Animal>  list  = new  ArrayList<Animal>  < ) ; 

^ ArrayList<Dog>  dogs  = new  ArrayList<Dog> ( ) ; 
ArrayList<Aninial>  animals  = dogs; 
list<Dog>  dogList  = dogs; 

ArrayList<Object>  objects  = new  ArrayLiat<Object>()  ; 
List<Objact>  objList  = objects; 

ArrayList<Object>  objs  = new  ArrayList<Dog>()  ; 
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Release  Your  Code 


It’s  time  to  let  go.  You  wrote  your  code. You  tested  your  code. You  refined  your  code. 

You  told  everyone  you  know  that  if  you  never  saw  a line  of  code  again,  that'd  define,  But  in  the 
end,  you've  created  a work  of  art.  The  thing  actually  runs!  But  now  what?  How  do  you  give  it  to 
end  users?  What  exactly  do  you  give  to  end  users?  What  if  you  don't  even  know  who  your  end 
users  are?  In  these  final  two  chapters,  we'll  explore  how  to  organize,  package,  and  deploy  your 
Java  code.  We'll  look  at  local,  semi-local,  and  remote  deployment  options  including  executable 
jars,  Java  Web  Start,  RMI,and  Servlets.  In  this  chapter,  we'll  spend  most  of  our  time  on  organizing 
and  packaging  your  code— things  you'll  need  to  know  regardless  of  your  ultimate  deployment 
choice.  In  the  final  chapter,  we'll  finish  with  one  of  the  coolest  things  you  can  do  In  Java.  Relax. 
Releasing  your  code  Is  not  saying  goodbye. There's  always  maintenance... 


this  Is  a new  chapter  581 


Java  deployment 


deploying  your  application 

What  exactly  ir  a Java  application?  In  other  words, 
once  you're  done  with  development,  what  is  it  that  you 
deliver?  Chances  are,  your  end-users  don't  have  a system 
identical  to  yours.  More  importantly,  they  don't  have  your 
application.  So  now  it's  time  to  get  your  program  in  shape 
for  deployment  into  The  Outside  World.  In  this  chapter, 
we’ll  look  at  local  deployments,  including  Executable  Jars 
and  the  part-local/part-remote  technology  called  Java  Web 
Start-  In  the  next  chapter,  we'll  look  at  the  more  remote 
deployment  options,  including  RMI  and  Servlets. 


Deployment  options 


100%  Local  Combination  100%  Remote 


A Java  program  is  a bunch 
of  classes.  Thafs  the 
output  of  your  development. 

Tie  real  question  is  what 
to  do  with  those  classes 
when  you’re  done. 


0 Local 

The  entire  application  runs  on  the 
end-user’s  computer,  as  a stand-alone, 
probably  6UI,  program,  deployed  as 
an  executable  JAR  (we’ll  look  at  JAR 
in  a few  pages.) 

0 Combination  of  local  and  remote 

The  application  is  distributed  with  a 
client  portion  running  on  the  user's 
local  system,  connected  to  a server 
where  other  parts  of  the  application 
are  running, 

(D  Remote 

The  entire  Java  application  runs  on  a 
server  system,  with  the  client  accessing 
the  system  through  some  non-Java 
means,  probably  a web  browser. 


9 Brain  Barbell 


What  are  the  advantages  and 
disadvantages  of  delivering  your 
Java  program  as  a local,  stand- 
alone application  running  on 
the  end-user's  computer? 

What  are  the  adva  ntages  and 
disadvantages  of  delivering  your 
Java  program  as  web-based 
system  where  the  user  Interacts 
with  a web  browser,  and  the 
Java  code  runs  as  servlets  on  the 
server? 


But  before  we  really  get  into  the  whole  deployment  thing, 
let's  take  a step  back  and  look  at  what  happens  when  you've 
finished  programming  your  app  and  you  simply  want  to  pul) 
out  the  class  files  to  give  them  to  an  end-user.  What’s  really 
in  that  working  directory? 
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Imagine  this  scenario... 


Bob’s  happily  at  work  on  the  final  pieces  of  his  cool  new 
Java  program.  After  weeks  of  being  in  the  Tm-just- 
one<ompUe-away”  mode,  this  time  he’s  really 
done.  The  program  is  a fairly  sophisticated 
GUI  app,  but  since  the  bulk  of  it  is  Swing 
code,  he’s  made  only  nine  classes  of  his 
own. 


At  last,  it’s  time  to  deliver  the  program  to  the 
client.  He  figures  all  he  has  to  do  is  copy  the 
nine  class  files,  since  the  client  already  has 
the  Java  API  installed.  He  starts  by  doing  an 
Is  on  the  directory  where  all  his  files  are... 


Whoa!  Something  strange  has  happened.  Instead  of  18 
files  (nine  source  code  files  and  nine  compiled  class 
files),  he  sees  51  files,  many  of  which  have  very  strange 
names  like: 


AccountSFilelistener.class 


Chart$SaveListener.clas$ 


and  on  it  goes.  He  had  completely  forgotten 
that  the  compiler  has  to  generate  class  files 
for  all  those  inner  class  GUI  event  listeners 
he  made,  and  that's  what  all  the  strangely- 
named  classes  are. 

Now  he  has  to  carefully  extract  all  the  class 
files  he  needs.  If  he  leaves  even  one  of  them  out, 
his  program  won't  work.  But  it’s  tricky  since  he 
doesn’t  want  to  accidentally  send  the  client 
one  of  his  source  c ode  files,  yet  everything  is 
in  the  same  directory  in  one  big  mess. 
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Separate  source  code  and  class  files 

A single  directory  with  a pile  of  source  code  and  class  files  is  a 
mess.  It  turns  out,  Bob  should  have  been  organizing  his  files 
from  the  beginning,  keeping  the  source  code  and  compiled 
code  separate.  In  other  words,  making  sure  his  compiled  class 
files  didn’t  land  in  the  same  directory  as  his  source  code. 

The  key  is  a combination  of  directory  structure  organization  and  the 
-d  compiler  option. 

There  are  dozens  of  ways  you  can  organize  your  files,  and  your 
company  might  have  a specific  way  they  want  you  to  do  it  We 
recommend  an  organizational  scheme  that’s  become  almost 
standard,  though. 

With  this  scheme,  you  create  a project  directory,  and  inside 
that  you  create  a directory  called  source  and  a directory  called 
classes.  You  start  by  saving  your  source  code  (java  files)  into 
the  source  directory,  Then  the  trick  is  to  compile  your  code 
in  such  a way  that  the  output  (the  .class  files)  ends  up  in  the 
classes  directory. 

And  there’s  a nice  compiler  flag,  -d,  that  lets  you  do  that 


Compiling  with  the  -d  (directory)  flag 


MyApp . j ava 

\ 

f'lU  to 


%cd  MyProject/source 
%javac  -d  ../classes 

kHs  -the  toiler  {0  p„i  i, 

Compiled  code  Ulan  4s) 

, agjin  Wok  We 

w«rk^  dirulory. 

By  using  the  -d  flag,  you  get  to  decide  which  directory  the 
compiled  code  lands  in,  rather  than  accepting  the  default  of 
class  files  landing  in  the  same  directory  as  the  source  code. 
To  compile  all  the  java  files  in  the  source  directory,  use: 


TtflS  dwtttw'f 


%javae  -d  ../classes  *.java 

\ * 


here 


Running  your  code 

%cd  MyProject/classes 
%java  Mini 


java  tommies  A^L 

sou rti  file*  i" 
tu i-rtfA  faruWj 


miti  Q 

LoxperQ 

mim 

luw  MfM 

mtucoooic 

Lit  Y«ro 

1010  10  0 

oma  i 

tugiMfoUr* 

itmnoi 

da  tUfuli 

ioiojcio 

da  4*1  dip 

1 DC  1C  101 01 

MyApp.cla&s 


MyApp.Java 


tK<  diwUy, 


(trovbl«Wfmg  note:  everyth', ng  in  -this  dkapttv  assays  that  the 
dumn-t  working  iWeeiory  (',.e  be  “")  ij  in  your  dlasipatH.  |f  you 
kav<  «*plidifjy  set  a dlasspatb  envi*-<mn.tni  variable,  he  do-bin 
fkat  if  tonfairit  "Z1 ) 
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Put  your  Java  in  a JAR 


0AJAR  file  is  a Java  ARchive.  It's  based  on  the  pkzip  file  format,  and  it  lets  you  bundle 
all  your  classes  so  that  instead  of  presenting  your  client  with  28  class  files,  you  hand 
over  just  a single  JAR  file.  If  you're  familiar  with  the  tar  command  on  UNIX,  you'll 
recognize  the  jar  tool  commands.  (Note:  when  we  say  JAR  in  all  caps,  we're  referring 
to  the  archive  file.  When  we  use  lowercase,  we're  referring  to  the  Jar  too/ you  use  to 
create  JAR  files.) 

The  question  is,  what  does  the  client  do  with  the  JAR?  How  do  you  get  it  to  run? 

You  make  the  JAR  executable. 


An  executable  JAR  means  the  end-user  doesn't  have  to  pull  the  class  files  out  before 
running  the  program.  The  user  can  run  the  app  while  the  class  files  are  still  in  the 
JAR-  The  trick  is  to  create  a manifest  file,  that  goes  in  the  JAR  and  holds  information 
about  the  files  in  the  JAR.  To  make  a JAR  executable,  the  manifest  must  tell  the  JVM 
which  class  has  the  main()  metkod! 


Making  an  executable  JAR 

£ Make  sure  all  of  your  class  files  are 
the  classes  directory 

We're  going  to  refine  this  in  a few  pages,  but 
for  now,  keep  all  your  class  files  sitting  in  the 
directory  named  'classes'. 


in 


i 


101101 
141101 
101  Oil 


* 


•s 


jouoi 
101101 
10101644416 
1014  16  6 
01014  1 

1010141 
14101010 
14014 lOlOl 


MyApp.dass 


Create  a manifest.txt  file  that  states 
which  class  has  the  mainO  method 

Make  a text  file  named  manif  est.txt  that  has  a 
one  line:  . . „ , 

*****  4- the  e*d 


Main-Class : 


Press  the  return  key  after  typing  the  Main- 
Class  line,  or  your  manifest  may  not  work 
correctly.  Put  the  manifest  file  into  the  “classes" 
directory. 


£ Run  the  Jar  tool  to  create  a JAR  file 
that  contains  everything  in  the  classes 
directory,  plus  the  manifest. 

%cd  MiniProjact/classes 

%jar  -cvmf  aanifsst.txt  appl.jar  *. class 
OR 

%jar  -cvmf  manifest . txt  appl.jar  My  App. class 


manffesUxt 


Lode 

m the  JAR 


you  are  here  > 585 


executable  JAR 


Most  1oo%  local  Java 
apps  are  deployed  as 
executable  JAR  files. 


Running  (executing)  the  MR 

Java  (the  JVM)  is  capable  of  loading  a class  from  a JAR,  and  calling 
the  mam()  method  of  that  class.  In  fact,  the  entire  application  can 
stay  in  the  JAR.  Once  the  ball  is  rolling  (i.e.,  the  main()  method 
starts  running),  the  JVM  doesn’t  care  when  your  classes  come 
from,  as  long  as  it  can  find  them.  And  one  of  the  places  the  JVM 
looks  is  within  any  JAR  files  in  the  classpath.  If  it  can  seeaJAR,  the 
JVM  will  look  in  that  JAR  when  it  needs  to  find  and  load  a class. 


%cd  MyProject/classes 


oppl.jor 


% java  -jar  appl.  ja 

. 

l/ll",  f,‘S  i'll'  it. 


m jvai  i*  ” 

\i  to  m your  fclawath.  l to 
t&eti  »*y 

\i  bo  make  your  *orh*odirtLtc*y 
~ tto  plat«  Utbert  Ike  JnR  '*■ 


Depending  on  how  your  operating  system  is  configured,  you 
might  even  be  able  to  simply  double-click  the  JAR  file  to  launch 
it.  This  works  on  most  flavors  of  Windows,  and  Mac  OS  X.  You 
can  usually  make  this  happen  by  selecting  the  JAR  and  telling 
the  OS  to  “Open  with...**  (or  whatever  the  equivalent  is  on  your 
operating  system) . 


cfell^ijuestjons 


Why  can't  I just  JAR  up  an  entire  directory? 


What  did  you  just  say? 


The  JVM  looks  inside  the  JAR  and  expects  to  find 
what  It  needs  right  there . It  won't  go  digging  Into  other 
directories,  unless  the  class  Is  part  of  a package,  and  even 
then  the  JVM  looks  only  in  the  directories  that  match  the 
package  statement? 


A- 

You  can't  put  your  class  files  Into  some  arbitrary 
directory  and  JAR  them  up  that  way.  But  If  your  classes 
belong  to  packages, you  can  JAR  up  the  entire  package 
directory  structure.  In  fact,  you  must. We'll  explain  all  this  on 
the  next  page,  so  you  can  relax. 
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Put  your  classes  in  packages! 

So  you’ve  written  some  nicely  reusable  class  files,  and  you've 
posted  them  in  your  internal  development  Library  for  other 
programmers  to  use.  While  basking  in  the  glow  of  having 
just  delivered  some  of  the  (in  your  humble  opinion)  best 
examples  of  OO  ever  conceived,  you  get  a phone  call.  A 
frantic  one.  Two  of  your  classes  have  the  same  name  as 
the  classes  Fred  just  delivered  to  the  library.  And  all  hell  is 
breaking  loose  out  there,  as  naming  collisions  and  ambiguities 
bring  development  to  its  knees. 

And  all  because  you  didn't  use  packages!  Well,  you  did  use 
packages,  in  the  sense  of  using  classes  in  the  Java  API  that  are, 
of  course,  in  packages.  But  you  didn’t  put  your  own  classes 
into  packages,  and  in  the  Real  World,  that’s  Really  Bad. 


Package  structure  of  the  Java  APT  for: 


WeTe  going  to  modify  the  organizational  structure  from  the 
previous  pages,  just  a little,  to  put  classes  into  a package,  and 
to  JAR  the  entire  package.  Pay  very  close  attention  to  the 
subde  and  picky  details.  Even  the  tiniest  deviadon  can  stop 
your  code  from  compiling  and/or  running. 

Packages  prevent  class  name  conflicts 


java  text. NurnberFormat 
javautilArrayList 
java.awt.FlowLayout 
javaawt  .event  ActionEvent 
java.net.Socket 


Although  packages  aren’tjust  for  preventing  name  collisions, 
that’s  a key  feature.  You  might  write  a class  named  Customer 
and  a class  named  Account  and  a class  named  ShoppingCart 
And  what  do  you  know,  half  of  all  developers  working  in 
enterprise  e-commerce  have  probably  written  classes  with 
those  names.  In  an  OO  world,  that's  just  dangerous.  If  part  of 
the  point  of  OO  is  to  write  reusable  components,  developers 
need  to  be  able  to  piece  together  components  from  a 
variety  of  sources,  and  build  something  new  out  of  them. 

Your  components  have  to  be  able  to  'play  well  with  others’, 
including  those  you  didn’t  write  or  even  know  about. 

Remember  way  back  in  chapter  6 when  we  discussed  how 
a package  name  is  like  the  full  name  of  a class,  technically 
known  as  the  fully-qualified  name.  Class  ArrayList  is  really 
java.uHLArrayList,  JButton  is  really  javax.sunng.JButtany  and 
Socket  is  really  java.netSockft  Notice  that  two  of  those  classes, 
ArrayList  and  Socket,  both  have  java  as  their  “first  name”. 

In  other  words,  the  first  part  of  their  fully-qualified  names 
is  “java".  Think  of  a hierarchy  when  you  think  of  package 
structures,  and  organize  your  classes  accordingly 


java 


ActionEvent 


What  does  this  picture  look  like  to 
you?  Doesn't  It  look  a whole  tot  like 
a directory  hierarchy? 
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package  naming 


Preventing  package  name  conflicts 

Putting  your  class  in  a package  reduces  the  chances  of  naming 
conflicts  with  other  classes,  but  what’s  to  stop  two  programmers 
from  coming  up  with  identical  package  names?  In  other  words, 
what’s  to  stop  two  programmers,  each  with  a class  named  Account, 
from  putting  the  class  in  a package  named  shopping.customers? 
Both  classes,  in  that  case,  would  still  have  the  same  name: 

shopping.customers  Account 


Packages  can  prevent  name 
conflicts,  but  only  if  you 
choose  a package  name 
that’s  guaranteed  to  be 
uniijue.  The  best  way  to 
do  that  is  to  preface  your 
packages  with  your  reverse 
domain  name. 


com.headfirstbooks.Book 


paikage  name 


t 


t\& 


Sun  strongly  suggests  a package  naming  convention  that  greatly 
reduces  that  risk — prepend  every  class  with  your  reverse  domain 
name.  Remember,  domain  names  are  guaranteed  to  be  unique. 
Two  different  guys  can  be  named  Bartholomew  Simpson,  but  rwo 
different  domains  cannot  be  named  doh.com. 


Reverse  domain  package  names 


com.headfirstjavQ.projects.Chart  i — 


vU-t  the  package  tTn 
do^a'm,  separated  by  a p. 
then  add  yow 
stru6'tuv’C  aftey 


prejed-bChaH  might  be  a Common 
name,  but  adding  Com.head-firjtiava 
mca^s  we  have  to  wo*vy  about  llv 
own  m-hou*£  dev^lopfri. 
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put  your  class  in  a package: 

Choose  a package  name 

Were  using  com.  headfirst  java  as  our 
example.  The  class  name  is  PackageExercise, 
sc  *he  fully-quairfied  name  of  the  class  is  now: 
cam . headfirstjava . PackageExercise. 

ftrt  a package  statement  in  your  class 

► It  most  be  the  first  statement  in  the  source 
cr ze  file,  above  any  import  statements.  There 
be  only  one  package  statement  per  source 
ccce  file,  so  all  classes  in  a source  file  must 
L to  m the  same  package.  That  includes  inner 
cesses,  of  course. 


package  com . headfirst java ; 

import  j avax . swing . * ; 

public  class  PackageExercise  { 
//  life-altering  code  here 
J 


0 Set  up  a matching  directory  structure 

It's  not  enough  to  say  your  doss  is  in  o package, 
&f  merely  putting  a package  statement  in 
the  code.  Your  class  isn't  truly  in  a package 
«TTif  you  put  the  class  in  a matching  directory 
structure.  So,  if  the  fully-qualified  class  name 
ts  com.headfirstjava.PackageExercise,  you 
raystput  the  PackageExercise  source  code  in  o 
Directory  named  headfirstjava,  which  must  be  in 
a directory  named  com. 

If  is  possible  to  compile  without  doing  that,  but 
trust  us— it's  not  worth  the  other  problems 
I youiW  have.  Keep  your  source  code  in  a directory 
structure  that  matches  the  package  structure, 
rrd  youli  avoid  a ton  of  painful  headaches  down 
the  road. 


You  must  put  a class 
into  a directory 
structure  that  matches 
the  package  hierarchy. 


My  Project 


IM* 

'r  r 

4a  4*1  Alp 


Package  Exarclse.cla&s  PackageExercise, Java 

Set  up  a matching  directory  structure  for 
both  the  source  and  classes  trees. 
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compile  and  run  with  packages 


Compiling  and  running  with  packages 

When  your  class  is  in  a package,  it’s  a little  trickier  to  compile  and 
run*  The  main  issue  is  that  both  the  compiler  and  JVM  have  to  be 
capable  of  finding  your  class  and  all  of  the  other  classes  it  use s. 
For  the  classes  in  the  core  API,  that’s  never  a problem.  Java  always 
knows  where  its  own  stuff  is.  But  for  your  classes,  the  solution 
of  compiling  from  the  same  directory  where  the  source  files  are 
simply  won’t  work  (or  at  least  not  reliably ).  We  guarantee,  though, 
that  if  you  follow  the  structure  we  describe  on  this  page,  you’ll  be 
successful.  There  are  other  ways  to  do  it,  but  this  is  the  one  we’ve 
found  the  most  reliable  and  the  easiest  to  stick  to. 


MOT  ti  do** 


Compiling  with  the  -d  (directory)  flag 

. . m divccW  ^ ^ . J 

%cd  MyPro  ject/ source  ^ wkcr*  W * 

com/headfirst  java/PackageExarci 

io 


%ja vac  -d  ../classes 

, .{^  ^ ijfr  pu-t  ike  *»* 

rpiLd  d,ede 

div-ttW 

pa<.^/e 

files  in  the  com.headfirstjava 


iso. java 


i \you  no"- 

attwal  *’ 


,0  i 
iet  to  tk« 


To  compile  all  the  java 
package,  use: 

%javac  -d  . ./classes 


com/headfixs  t j ava/ * . java 
/ ‘ 

hle  IB  ^ 


Running  your  code 

%cd  MyProject/classes 
% j ava  com . headfiratj ava . PackageExerci se 


IT  ^ 


y- 


PackageExerclsa.class  PackageExerdaajava 
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The  -d  flag  is  even  cooler  than  we  said 


Compiling  with  the  -d  flag  is  wonderful  because  not  only  does  it 
let  you  send  your  compiled  class  files  into  a directory  other  than 
the  one  where  the  source  file  is,  but  it  also  knows  to  put  the  class 
into  the  correct  directory  structure  for  the  package  the  class  is  in. 

But  it  gets  even  better! 


Let’s  say  that  you  have  a nice 
directory  structure  all  set  up  for  your 
source  code.  But  you  haven't  set 
up  a matching  directory  structure 
for  your  classes  directory.  Not  a 
problem!  Compiling  with 
<1  tells  the  compiler  to  not 
just  put  your  classes  into 
correct  directory  tree,  but  to 
the  directories  if  they  don’t 


If  the  vaduy 
doesn't  «w*t  under  the 
diretW/i  the  t^\er  ^W  Ud  the 
directories  if  Y<*  ■*“  'd  * 

So  vou  don't  actually  have  to 

physically  ereate  the  directories  u,der 

the’ cl  asses'  root  directory- 
fact  Y*u  let  the  compiler  do  it 
therms  *o  ^ W?°r 


lur* 


PackageExerdse.Java 


The  -d  flag  tells  the  compiler, 
“Put  the  class  into  Its  package 
directory  structure,  using  the 
class  specified  after  the  -d  as 
the  root  directory.  But...  If  the 
directories  aren’t  there,  create 
them  first  and  then  put  the  class 
In  the  right  place!” 


I tried  to  cd  into  the 
directory  where  my  main  class 
was,  but  now  the  JVM  says  it  can't 
find  my  class!  But  it's  right  THERE 
in  the  current  directory! 

A. 

-rL-  Once  your  class  Is  in  a 
package, you  can't  call  it  by  its 
'short' name.  You  MUST  specify, 
at  the  command-line,  the  fully- 
qualified  name  of  the  class  whose 
mainO  method  you  want  to  run. 
But  since  the  fully-qualified  name 
Includes  the  package  structure, 
Java  insists  that  the  class  be  in  a 
matching  directory  structure.  So  if 
at  the  command-line  you  say: 

%java  com. foo. Book 

the  JVM  will  look  in  its  current 
directory  (and  the  rest  of  Its 
classpath),  for  a directory  named 
"com*  It  wilt  not  look  for  a class 
named  Book,  until  it  has  found 
a d/rectory  named  "com"  with  a 
directory  inside  named  "foo" Only 
then  will  the  JVM  accept  that  its 
found  the  correct  Book  class.  If  it 
finds  a 8ook  class  anywhere  else, 
it  assumes  the  class  isn't  in  the 
right  structure,  even  if  it  is!  The 
JVM  won't  for  example,  look  back 
up  the  directory  tree  to  say, "Oh,  I 
can  see  that  above  us  is  a directory 
named  com,  so  this  must  be  the 
right  package..." 
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JARs  and  packages 


Making  an  executable  JAR  with  packages 


When  your  class  is  in  a package,  t he  package  directory  structure 
must  be  inside  the  JAR!  You  can’t  just  pop  your  classes  in  the 
JAR  the  way  we  did  pre-packages.  And  you  must  be  sure  that  you 
don't  include  any  other  directories  above  your  package.  The 
first  directory  of  your  package  (usually  com)  must  be  the  first 
directory  within  the  JAR!  If  you  were  to  accidentally  include  the 
directory  above  the  package  (e.g.  the  “classes'1  directory),  the  JAR 
wouldn't  work  correcdy. 


Making  an  executable  JAR 

£ Make  sure  all  of  your  class  files  are 
within  the  correct  package  structure, 
under  the  classes  directory. 


£ Create  a manifest.txt  file  that  states 
which  class  has  the  mainO  method, 
and  be  sure  to  use  the  fully- qualified 
class  name! 

Make  o text  file  named  manifest.txt  that  has  a 

single  fine: 

Main-Class : com. headfirst java . PackagaExercise 
Put  the  manifest  file  into  the  classes  directory 


Run  the  jar  tool  to  create  a JAR  file 
that  contains  the  package  directories 
plus  the  manifest 

The  only  thing  yau  need  to  include  is  the  'com* 
directory,  and  the  entire  package  (and  all  classes) 
will  go  into  the  JAR. 

%cd  MyPro ject/classas 


vt! 


I 


pockEx.jor 


%jar  -cvmf  manifest.txt  packEx.jar  com 


P*ckag«Exerdft«.cius 
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So  where  did  the  manifest  file  go? 

Why  don’t  we  look  inside  the  JAR  and  find  out?  From  the 
command-line,  the  jar  tool  can  do  more  than  just  create  and  run  a 
JAR.  You  can  extract  the  contents  of  aJAR  (just  like  ‘unzipping'  or 
luntarring'). 

Imagine  you've  put  the  packEx  jar  into  a directory  named  Skyler. 


jar  commands  for  listing  and  extracting 

List  the  contents  of  a JAR 

% jar  -tf  packEx. jar 

I .7^  ^ds  (oy  <Tai.J.  f“.i  , 


i v 'iAR  Wt  3 


f * JAR  tilcu 


I Fite  Edit  Window  Halo  PicJde 


% cd  Skyler 

% jar  -tf  packEx. jar 

META-INF/ 

META-INF/MANIFEST . MF 
com/ 

com/headf irst java/ 
com/headf irst java/ 
PackageExercise . class 


[packExJa 


r-> — 


META-INF  \ 


Ihtodfiisifav 


MANIFEST, MF 


Extract  the  contents  of  a JAR  (i.e.  unjar) 

% cd  Skyler 

% jar  -xf  packEx. jar  ( A 


-*f  for  '$*brKt  Ht 

works  Vwfc  I'b  f w»t**"J* 

If  vou  e^adt  the  pat It*#*,  ^ '} 

see  the  META-IKt  ^eclo *-y  a*d  the 

dirccUY  diretUv  » ^ 

directory 


HEnUMFl 


MANIFEST.MF 


Package  Exe  rtl  se , cl  ass 

META-INF  stands  for  'meta 
Inf  ormation'.  The  jar  tool  creates 
the  META-INF  directory  as 
well  as  the  MANIFEST.MF  file. 
It  also  takes  the  contents  of 
your  manifest  file,  and  puts  it 
into  the  MANIFEST.MF  file.  So, 
your  manifest  file  doesn't  go  into 
the  JAR,  but  the  contents  of  it 
are  put  into  the  'real'  manifest 
(MANIFEST.MF). 


P&cfcagaExorclM.class 
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organizing  your  classes 


your  penuii 


to  114  J' 

Lorpi? 

« U o 

«n  ci 

Foof.class  Foof.Java 


Given  the  package/directory  structure  in  this 
plcture,figure  out  what  you  should  type  at  the 
command-line  to  compile,  run,  create  a JAR,  and 
execute  a JAR.  Assume  we're  using  the  standard 
where  the  package  directory  structure  starts  just 
below  source  and  classes . In  other  words,  the  source 
and  classes  directories  are  not  part  of  the  package. 


Compile: 

%cd  source 
%javac  

Run: 

%cd  

%java  


Create  a J Aft 

%cd  

% 

Execute  a JAR 

%cd  

% 


Bonus  question:  What's  wrong  with  the  package  name? 
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DuSll^t^uestlpns 

Q,*  What  happens  If  you  try 
to  run  an  executable  JAR,  and 
the  end-user  doesn't  have  java 
Installed? 

Nothing  will  run,  since 
without  a JVM  Java  code  can't 
run.The  end-user  must  have  Java 
Installed. 


% How  can  I get  Java 
installed  on  the  end-user's 
machine? 

Ideally,  you  can  create  a custom 
installer  and  distribute  It  along 
with  your  application.  Several 
companies  offer  Installer  pro- 
grams ranging  from  simple  to 
extremely  powerful.  An  installer 
program  could,  for  example,  de- 
tect whether  or  not  the  end-user 
has  an  approproprlate  version 
of  Java  installed,  and  If  not, 

Install  and  configure  Java  before 
Installing  your  application, 
Installshleld,  InstallAnywhere, 
and  DeployDlrector  all  offer  Java 
installer  solutions. 

Another  cool  thing  about  some 
of  the  Installer  programs  is  that 
you  can  even  make  a deploy- 
ment CD-ROM  that  Includes 
Installers  for  all  major  Java 
platforms,  so,.,  one  CD  to  rule 
them  all.  If  the  user's  running  on 
Solaris,  for  example,  the  Solaris 
version  of  Java  Is  installed.  On 
Windows,  the  Windows,  ver- 
sion etc  If  you  have  the  budget, 
this  1$  by  far  the  easiest  way  for 
your  end-users  to  get  the  right 
version  of  Java  Installed  and 
configured. 


BULLET  POIKTS^i® 

■ Organize  your  project  so  that  your  source  code  and  class  files  are  not  in 
Ihe  same  directory. 

■ A standard  organization  structure  is  to  create  a project  directory,  and  then 
put  a source  directory  and  a classes  directory  inside  the  project  directory. 

■ Organizing  your  classes  into  packages  prevents  naming  collisions  with 
other  classes,  if  you  prepend  your  reverse  domain  name  on  to  the  front  of 
a class  name. 

■ To  put  a class  in  a package,  put  a package  statement  at  the  top  of  the 
source  code  file,  before  any  import  statements: 

package  com.  wickedlysmart; 

■ To  be  in  a package,  a class  must  be  in  a directory  structure  that  exactly 
matches  the  package  structure.  For  a class,  com.wfckedlysmartFoo, 
the  Foo  class  must  be  in  a directory  named  wickedlysmart,  which  is  in  a 
directory  named  com. 

■ To  make  your  compiled  class  land  in  the  correct  package  directory 
structure  under  the  classes  directory,  use  the  -d  compiler  flag: 

% cd  source 

% javac  -d  ../classes  oom/wickedlysmart/Foo. java 

■ To  run  your  code,  cd  to  the  classes  directory,  and  give  the  fully-qualified 
name  of  your  class: 

% cd  classes 

% jave  com . wickedlysmart . Foo 

a You  can  bundle  your  classes  into  JAR  (Java  ARchive)  files.  JAR  is  based 
on  the  pkzip  format. 

■ You  can  make  an  executable  JAR  file  by  putting  a manifest  Into  the  JAR 
that  states  which  dass  has  the  malnO  method.  To  create  a manifest  file, 
make  a text  file  with  an  entry  like  the  following  (for  example): 
Main-Class:  com. wickedlysmart. Foo 

■ Be  sure  you  hit  the  return  key  after  typing  the  Main-Class  line,  or  your 
manifest  file  may  not  work. 

■ To  create  a JAR  file,  type: 

jar  -cv£m  manifest . txt  MyJar.jar  com 

■ The  entire  package  directory  structure  (and  only  the  directories  matching 
the  package)  must  be  Immediately  Inside  the  JAR  file. 

■ To  run  an  executable  JAR  file,  type: 

java  -jar  MyJar.jar 
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wouldn't  it  be  dreamy ... 


Executable  JAR  files 
( are  nice,  but  wouldn't  it  be  dreamy 
\ if  there  were  a way  to  make  a rich,  stand- 
y alone  client  GUI  that  could  be  distributed 
over  the  Web?  So  that  you  wouldn’t  have  to 
press  and  distribute  all  those  CD-ROMs.  And 
wouldn't  it  be  just  wonderful  if  the  program 
y could  automatically  update  itself , replacing 
f just  the  pieces  that  changed?  The  clients 
V would  always  be  up-to-date,  and  you'd  never 
have  to  worry  about  delivering  new 
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100%  Local  Combination  100%  Remote 


Java  Web  Start 

With  Java  Web  Start  (JWS),  your  application  is  launched  for  the 
first  time  from  a Web  browser  (get  it?  Web  StarQ)  but  it  runs  as  a 
stand-alone  application  (well,  almost) , without  the  constraints  of  the 
browser.  And  once  it's  downloaded  to  the  end-user’s  machine  (which 
happens  the  first  time  the  user  accesses  the  browser  link  that  starts 
the  download)  , it  stays  there. 

Java  Web  Start  is(  among  other  things,  a small  Java  program  that  lives 
on  the  client  machine  and  works  much  like  a browser  plug-in  (the 
way,  say,  Adobe  Acrobat  Reader  opens  when  your  browser  gets  a .pdf 
file).  This  Java  program  is  called  the  Java  Web  Start  ‘helper  app1, 
and  its  key  purpose  is  to  manage  the  downloading,  updating,  and 
launching  (executing)  of  your  JWS  apps. 

When  JWS  downloads  your  application  (an  executable  JAR),  it 
invokes  the  main()  method  for  your  app.  After  that,  the  end-user  can 
launch  your  application  directory  from  the  JWS  helper  app  without 
having  to  go  back  through  the  Web  page  link. 

But  that's  not  the  best  part.  The  amazing  thing  about  JWS  is  its 
ability  to  detect  when  even  a small  part  of  applicadon  (say,  a single 
class  file)  has  changed  on  the  server,  and — without  any  end-user 
intervention — download  and  integrate  the  updated  code. 

There’s  still  an  issue,  of  course,  like  how  does  the  end-user  g?/Java 
and  Java  Web  Start?  They  need  both— Java  to  run  the  app,  and  Java 
Web  Start  (a  small  Java  application  itself)  to  handle  retrieving  and 
launching  the  app.  But  even  that  has  been  solved.  You  can  set  things 
up  so  that  if  your  end-users  don’t  have  JWS,  they  can  download 
it  from  Sun,  And  if  they  do  have  JWS,  but  their  version  of  Java  is 
out-of-date  (because  you've  specified  in  your  JWS  app  that  you 
need  a specific  version  of  Java),  the  Java  2 Standard  Edition  can  be 
downloaded  to  the  end-user  machine. 

Best  of  all,  it’s  simple  to  use.  You  can  serve  up  a JWS  app  much  like 
any  other  type  of  Web  resource  such  as  a plain  old  HTML  page  or  a 
JPEG  image.  You  set  up  a Web  (HTML)  page  with  a link  to  your  JWS 
application,  and  you’re  in  business. 

In  the  end,  your  JWS  application  isn’t  much  more  than  an 
executable  JAR  that  end-users  can  download  from  the  Web. 


End-users  launch  a Java 
Web  Start  app  by  clicking 
on  a link  in  a Web 
page.  But  once  the  app 
downloads,  it  runs  outside 
the  browser,  just  like  any 
other  stand-alone  Java 
application.  In  fact,  a 
Java  Web  Start  app  is  just 
an  executable  JAR  that's 
distributed  over  -die  Web* 
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Java  Web  Start 


How  Java  Web  Start  works 

The  client  dicks  on  a Web  page  link 
to  your  JWS  application  (a  .jnlp  file). 

The  Web  page  link 

<a  hraf="MyApp. jnlp”>Click</a> 


trows^- 


me 


The  Web  server  (HTTP)  gets  the 
request  and  sends  back  a .Jnlp  file 
(this  is  NOT  the  JAR). 

The  Jnlp  file  is  an  XML  document  that 
states  the  name  of  the  application's 
executable  JAR  file. 


Java  Web  Start  (a  small  'helper  app‘ 
on  the  client)  is  started  up  by  the 
browser.  The  JWS  helper  app  reads 
the  .jnlp  file,  and  asks  the  server  for 
the  My  App  .jar  file. 


Jg.a  Web  SUrt 


(J)  The  Web  server  ‘serves'  up  the 
requested  .jar  file. 


Java  Web  Start  gets  the  JAR  and 
starts  the  application  by  calling  the 
specified  main()  method  (just  like  an 
executable  JAR). 


IfellotVcbStart 


ipp  in 


Next  time  the  user  wants  to  run  this  app.  he  can 
open  the  Java  Web  Start  application  and  from 
there  launch  your  app,  without  even  being  online. 


tie  OAR) 


598  chapter  1 7 


package,  jars  and  deployment 


the  .jnlp  file 


To  make  a Java  Web  Start  app,  you  need  to  jnlp  (Java  Network 
Launch  Protocol)  file  that  describes  your  application.  This  is  the 
file  the  JWS  app  reads  and  uses  to  find  your  JAR  and  launch  the 
app  (by  calling  the  JAR's  main()  method).  A jnlp  file  is  a simple 
XML  document  that  has  several  different  things  you  can  put  in, 
but  as  a minimum,  it  should  look  like  this: 


<?xml  version="1.0"  encoding* "utf -8" ?>  Vf 


****  % ** 


TJhbtC  * -r  '^.0.0.1' ■ 

the  Yrl  l 


art^ 


<jnlp  spec*" 0.2  1.0" 

codebase="http : //127 .0.0. l/~kathy 
href="MyApp. jnlp">  ^ — ___ 

todebase-  t n<>  ~v  j r u ; 

available  m the  root  d.r etW  the 


k «.  I-*.  ^ *■ 


nesTed  m some  oThcv  diccdTory 


<information> 

<title>kathy  App</title> 
<vendor>Wickedly  Smart</ vendor > 
<homepage  href *"index . html " /> 


Se  JWS  helper  a??,  ^ 

*a„fe  to  r<la*nth  a ^ev^ly-a^loaded  aP? 


<description>Head  First  WebStart  demo</description> 
<icon  href*"kathys.gif"/> 

<offline-allowed/> 

JC. 

< / inf orma tion> 


Tte  T «.  7 rr 


<resources> 

<j2se  version="1.3+"/> 

< jar  href="MyApp . jar"/> <_ 7^  ^ ^ 
< /resour ces> 


This  sa^s  that  aPP  «eeds  version  I 
Java,  or  greater 


<application-desc  main-class*"HelloWebStart"/> 

</  jnlp>  ^ — This  is  like  The  main-fesT  Mam-Class  eniry ...  ii  says 

whieh  elass  m The  JAR  has  The  *amO  method. 
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Steps  for  making  and  deploying 
a Java  Web  Start  app 


Make  an  executable  JAR 
for  your  application. 


MyApp.]ar 


(|!)  Write  a .Jnlp  file. 


MyApp.Jnlp 


(5)  Place  your  JAR  and  .jnlp 
files  on  your  Web  server. 


Add  a new  mime  type  to  your  Web  server. 

application/*- java- jnlp-fil* 

This  causes  the  server  to  send  the  .jnlp  file  with  the 
correct  header,  so  that  when  the  browser  receives 
the  jnlp  file  it  knows  what  it  is  and  knows  to  start 
the  JWS  helper  app. 


® 


Create  a Web  page  with  a link 
to  your  .jnlp  file 

<HTML> 

<BODY> 


MyJWSApp.html 


<a  href="MyApp2 . jnlp">Launch  My  Application</a> 
</BODY> 

</HTML> 
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Look  at  the  sequence  of  events  below,  and 
place  them  in  the  order  In  which  they 
occur  In  a JWS  application. 


1. 

2. 

3. 


Qjl  How  Is  Java  Web  Start  different  from  an  applet? 


A- 

*\‘  Applets  can't  live  outside  of  a Web  browser  An  applet  is 
downloaded  from  the  Web  as  part  of  a Web  page  rather  than 
simply  from  a Web  page.  In  other  words,  to  the  browser,  the  applet 
Is  just  like  a JPEG  or  any  other  resource.  The  browser  uses  either  a 
Java  plug-ln  or  the  browser's  own  built-in  Java  (far  less  common 
today)  to  run  the  applet.  Applets  don't  have  the  same  level  of 
functionality  for  things  such  as  automatic  updating,  and  they  must 
always  be  launched  from  the  browser.  With  JWS  applications,  once 
they're  downloaded  from  the  Web,  the  user  doesn't  even  have  to 
be  using  a browser  to  relaunch  the  application  locally.  Instead, 
the  user  can  start  up  the  JWS  helper  app,  and  use  It  to  launch  the 
already-downloaded  application  again. 


What  are  the  security  restrictions  of  JWS? 

A- 

Jr\ - JWS  apps  have  several  limitations  Including  being 
restricted  from  reading  and  writing  to  the  user's  hard  drive.  But.,. 
JWS  has  Its  own  API  with  a special  open  and  save  dialog  box  so 
that,  with  the  user's  permission,  your  app  can  save  and  read  Its 
own  files  In  a special,  restricted  area  of  the  user's  drive. 


BULLET  POINTS  

■ Java  Web  Start  technology  lets  you  deploy  a 
stand-alone  client  application  from  the  Web. 

■ Java  Web  Start  includes  a 'helper  app'  that  must 
be  installed  on  the  client  (along  with  Java). 

■ A Java  Web  Start  (JWS)  app  has  two  pieces: 
an  executable  JAR  and  a .jnlp  file. 

■ A .jnlp  file  is  a simple  XML  document  that 
describes  your  JWS  application , It  includes 
tags  for  specifying  the  name  and  location  of  the 
JAR,  and  the  name  of  the  class  with  the  main() 
method. 

■ When  a browser  gets  a .jnlp  file  from  the  server 
(because  the  user  clicked  on  a link  to  the  .jnlp 
file),  the  browser  starts  up  the  JWS  helper  app. 

■ The  JWS  helper  app  reads  the  .jnlp  file  and 
requests  the  executable  JAR  from  the  Web 
server. 

■ When  the  JWS  gets  the  JAR,  it  invokes  the 
mainQ  method  (specified  in  the  .jnlp  file). 
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exercise:  True  or  False 


We  explored  packaging,  deployment, and  JWS 
in  this  chapter.  Your  job  is  to  decide  whether 
each  of  the  following  statements  is  true  or  false. 


ok  Fffl.se  ^ 


1.  The  Java  compiler  has  a flag,  -d,  that  lets  you  decide  where  your  .class  files  should  go. 

2.  AJAR  is  a standard  directory  where  your  .class  files  should  reside. 

3.  When  creating  a Java  Archive  you  must  create  a file  called  jar.mf. 

4.  The  supporting  file  in  a Java  Archive  declares  which  class  has  the  main()  method. 

5.  JAR  files  must  be  unzipped  before  the  JVM  can  use  the  classes  inside. 

6.  At  the  command  line,  Java  Archives  are  invoked  using  the  -arch  flag. 

7.  Package  structures  are  meaningfully  represented  using  hierarchies. 

8.  Using  your  company’s  domain  name  is  not  recommended  when  naming  packages. 

9.  Different  classes  within  a source  file  can  belong  to  different  packages. 

10.  When  compiling  classes  in  a package,  the  -p  flag  is  highly  recommended. 

11.  When  compiling  classes  in  a package,  the  full  name  must  mirror  the  directory  tree. 

12.  Judicious  use  of  the  -d  flag  can  help  to  assure  that  there  are  no  typos  in  your  class  tree. 

13.  Extracting  a JAR  with  packages  will  create  a directory  called  meta-inf. 

14.  Extracting  a JAR  with  packages  will  create  a file  called  manifest.mf. 

15.  The  JWS  helper  app  always  runs  in  conjunction  with  a browser. 

16.  JWS  applications  require  a .nip  (Network  Launch  Protocol)  file  to  work  properly. 

17.  AJWS’s  main  method  is  specified  in  its  JAR  file. 
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package,  jars  and  deployment 


Bate 
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Anything  in  the  book 
is  fair  game  for  this 
one! 


Across 

6.  Wont  travel 

9.  Dont  split  me 

10.  Release-able 

11.  Got  the  key 

12.  I/O  gang 
15.  Flatten 

17.  Encapsulated  returner 

18.  Ship  this  one 

21.  Make  ft  so 

22.  I/O  sieve 
25.  Disk  leaf 


26.  Mine  is  unique 

27.  GUI's  target 

29.  Java  team 

30.  Factory 

32.  Forawhile 

33.  Atomic  * 8 
35.  Good  as  new 
37.  Pairs  event 

41.  Where  do  I start 

42.  A little  firewall 


Down 

1.  Pushy  widgets 

2.  of  my  desire 

3.  'Abandoned' moniker 

4.  A chunk 

5.  Math  not  trig 

6.  Be  brave 

7.  Arrange  well 

8.  Swing  slang 
11.  I/O  canals 

1 3.  Organized  release 

14.  Not  for  an  instance 


1 6.  Who's  allowed 

19.  Efficiency  expert 

20.  Early  exit 

21.  Common  wrapper 

23.  Yes  or  no 

24.  Java  jackets 
26.  Not  behavior 
28.  Socket's  suite 


30.  I/O  cleanup 

31.  Mlllf-nap 
34.  Trig  method 
36,  Encaps  method 

38.  JNLPfomnat 

39.  VB's  final 

40.  Java  branch 
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exercise  solutions 


True 

False 

False 

True 

False 

False 

True 

False 

False 

False 

True 

True 

True 

True 

False 

False 

False 


L The  Java  compiler  has  a flag,  -d,  that  lets  you  decide  where  your  .class  files  should  go. 

2.  AJAR  is  a standard  directory  where  your  .class  files  should  reside. 

3.  When  creating  a Java  Archive  you  must  create  a file  called  jar, mf. 

4.  The  supporting  file  in  ajava  Archive  declares  which  class  has  the  main()  method. 

5.  JAR  files  must  be  unripped  before  the  JVM  can  use  the  classes  inside. 

6.  At  the  command  line,  Java  Archives  are  invoked  using  the  'arch  flag. 

7.  Package  structures  are  meaningfully  represented  using  hierarchies. 

8.  Using  your  company's  domain  name  is  not  recommended  when  naraingpackages. 

9.  Different  classes  within  a source  file  can  belong  to  different  packages. 

10.  When  compiling  classes  in  a package,  the  -p  flag  is  highly  recommended. 

1 1 . When  compiling  classes  in  a package,  the  full  name  must  mirror  the  directory  tree. 

12.  Judicious  use  of  the  -d  flag  can  help  to  assure  that  there  are  no  typos  in  your  tree. 

13.  Extracting  a JAR  with  packages  will  create  a directory  called  meta-inf. 

14.  Extracting  a JAR  with  packages  will  create  a file  called  manifescmf. 

15.  The  JWS  helper  app  always  runs  in  conjunction  with  a browser. 

16.  JWS  applications  require  a ,nlp  (Network  Launch  Protocol)  file  to  work  properly. 

17.  AJWS's  main  method  is  specified  in  its  JAR  file. 
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1 8 remote  deployment  with  RMI 


Being  remote  doesn’t  have  to  be  a bad  thing.  Sure,  things  are  easier  when 
all  the  parts  of  your  application  are  in  one  place,  in  one  heap,  with  one  JVM  to  rule  them  all.  8ut 
that's  not  always  possible.  Or  desirable.  What  If  your  application  handles  powerful  computations, 
but  the  end-users  are  on  a wimpy  little  Java-enabled  device?  What  if  your  app  needs  data 
from  a database,  but  for  security  reasons,  only  code  on  your  server  can  access  the  database? 
Imagine  a big  e-commerce  back-end,  that  has  to  run  within  a transaction-management  system? 


Sometimes,  part  of  your  app  must  run  on  a server,  while  another  part  (usually  a client)  must 
run  on  a different  machine.  In  this  chapter,  we'll  learn  to  use  Java's  amazingly  simple  Remote 


Method  Invocation  (RMI)  technology.  We'll  also  take  a quick  peek  at  Servlets,  Enterprise  Java 
Beans  (EJB)  ,and  Jinl,  and  look  at  the  ways  In  which  EJB  and  Jinf  depend  on  RMI.  We'll  end  the 
book  by  writing  one  of  the  coolest  things  you  can  make  In  Java,  a universal  service  browser . 
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how  many  heaps? 


Method  calls  are  always  between 
two  objects  on  the  same  heap. 

So  far  in  this  book,  every  method  we've  invoked  has  been  on 
an  object  running  in  the  same  virtual  machine  as  the  caller 
In  other  words,  the  calling  object  and  the  callee  (the  object 
we're  invoking  the  method  on)  live  on  the  same  heap. 

class  Foo  { 

void  go()  { 

Bar  b = new  Bar ( ) ; 
b.doStuff () ; 

) 

public  static  void  main  (String []  args)  { 


In  most  applications,  when  one  object 
calls  a method  on  another,  both  objects 
are  on  the  same  heap.  In  other  words, 
both  are  running  within  the  same  JVM. 

} 

Tn  the  code  above,  we  know  that  the  Foo  instance 
referenced  by / and  the  Bar  object  referenced  by  b are 
both  on  the  same  heap,  run  by  the  same  JVM.  Remember, 
the  JVM  is  responsible  for  stuffing  bits  into  the  reference 
variable  that  represent  how  to  get  to  an  object  on  the  heap . 

The  JVM  always  knows  where  each  object  is,  and  how  to 
get  to  it.  But  the  JVM  can  know  about  references  on  only 
its  own  heapl  You  can't,  for  example,  have  a JVM  running 
on  one  machine  knowing  about  the  heap  space  of  a JVM 
running  on  a different  machine.  In  fact,  a JVM  running  on 
one  machine  can't  know  anything  about  a differentJVM 
running  on  the  same  machine.  It  makes  no  difference  if 
the  JVMs  are  on  the  same  or  different  physical  machines; 
it  matters  only  that  the  two  JVMs  are,  well,  two  different 
invocations  of  the  JVM. 


Foo  f = new  Foo ( ) ; 

f -g°0 ; 
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What  If  you  want  to  invoke  a method  on 
an  object  running  on  another  machine? 


We  know  how  to  get  information  from  one  machine  to  another — 
with  Sockets  and  I/O.  We  open  a Socket  connection  to  another 
machine,  and  get  an  OutputStream  and  write  some  data  to  it. 


But  what  if  we  actually  want  to  call  a method  on  something  running 
in  another  machine...  another  JVM?  Of  course  we  could  always  build 
our  own  protocol,  and  when  you  send  data  to  a ServerSocket  the 
server  could  parse  it,  figure  out  what  you  meant,  do  the  work,  and 
send  back  the  result  on  another  stream.  What  a pain,  though.  Think 
how  much  nicer  it  would  be  to  just  get  a reference 
the  other  machine,  and  call  a method. 


Imagine  two  computers. 


P'  PAihfu/ly 


Little 


Big 


Big  kas  sometking  Little  wants. 
Compute  power. 


Little  wants  to  send  some  data  to  Big,  so  tkat  Big  can  do  tke 
keavy  computing. 

Little  wants  simply  to  call  a metkocL. 


double  doCalcUsingDatabase (CalcNumbers  numbers) 


and  get  kack  tke  result. 

But  kow  can  Little  get  a reference  to  an  okject  on  Big? 
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two  objects,  two  heaps 


Object  A,  running  on  Little,  wants  to  call 
a method  on  Object  P,  running  on  Pig. 


The  question  is,  how  do  we  get  an  object  on  one  machine 
(which  means  a different  heap/JVM)  to  call  a method  on 
another  machine? 


Put  you  can't  do  that. 


Well,  not  directly  anyway.  You  can’t  get  a reference  to 
something  on  another  heap.  If  you  say: 

Dog  d = ??? 

Whatever  d is  referencing  must  be  in  die  same  heap  space  as 
the  code  running  the  statement 

But  imagine  you  want  to  design  something  that  will  use 
Sockets  and  I/O  to  communicate  your  intention  (a  method 
invocation  on  an  object  running  on  another  machine),  yet 
still  feelzs  though  you  were  making  a local  method  call. 

In  other  words,  you  want  to  cause  a method  invocation  on  a 
remote  object  (i.e.,  an  object  in  a heap  somewhere  else) , but 
with  code  that  lets  you  pretend  that  you're  invoking  a method 
on  a local  object.  The  ease  of  a plain  old  everyday  method 
call,  but  the  power  of  remote  method  invocation.  That's  our 
goal. 

That’s  what  RMT  (Remote  Method  Invocation)  gives  you! 

But  let's  step  back  and  imagine  how  you  would  design  RMI  if 
you  were  doing  it  yourself.  Understanding  what  you’d  have  to 
build  yourself  will  help  you  learn  how  RMI  works. 
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A design  for  remote  method  calls 

Create  four  things:  server,  client, 
server  helper,  client  helper 


Create  client  and  server  apps.  The  server  app  is  the 
remote  service  that  has  an  object  with  the  method 
that  the  client  wants  to  invoke. 


Create  client  and  server  'helpers'.  They'll  handle  all 
the  low-level  networking  and  I/O  details  so  your  client 
and  service  can  pretend  like  they're  in  the  same  heap. 
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client  and  server  helpers 


The  role  of  the  'helpers' 

The  'helpers'  are  the  objects  that  actually  do  the  communicating. 
They  make  it  possible  for  the  client  to  act  as  though  its  calling  a 
method  on  a local  object.  In  fact,  it  is.  The  client  calls  a method  on 
the  client  helper,  as  if  the  cUent  helper  were  the  actual  service.  The  client 
helper  is  a proxy  for  the  Real  Thing . 

In  other  words,  the  client  object  thinks  its  calling  a method  on 
the  remote  service,  because  the  client  helper  is  pretending  to  be 
the  service  object.  Pretending  to  be  the  thing  with  the  method  the  client 
wards  to  call! 

But  the  client  helper  isn't  really  the  remote  service.  Although  the 
client  helper  acts  like  it  (because  it  has  the  same  method  that  the 
service  is  advertising),  the  client  helper  doesn't  have  any  of  the 
actual  method  logic  the  client  is  expecting.  Instead,  the  client 
helper  contacts  the  server,  transfers  information  about  the  method 
call  (e.g.,  name  of  the  method,  arguments,  etc.),  and  waits  for  a 
return  from  the  server. 

On  the  server  side,  the  service  helper  receives  the  request  from 
the  client  helper  (through  a Socket  connection),  unpacks  the 
information  about  the  call,  and  then  invokes  the  real  method  on 
the  real  service  object.  So  to  the  service  object,  the  call  is  local.  It’s 
coming  from  the  service  helper,  not  a remote  client. 

The  service  helper  gets  the  return  value  from  the  service,  packs  it 
up,  and  ships  it  back  (over  a Socket’s  output  stream)  to  the  client 
helper.  The  client  helper  unpacks  the  information  and  returns  the 
value  to  the  client  object 


Your  client  object  get S to 
act  like  it’s  making  remote 
method  calls.  But  what 
ifs  really  doing  is  calling 
methods  on  a heap-local 
‘proxy’  object  that  handles 
all  die  low-level  details  of 
Sockets  and  streams. 


it's  talM  to -ye 

Real  Serwite-  l-t 

tVirVi  -tv.e 

kdf » '»  tk< 
tut  ac  i WJ 
do  tJne  vea\ 


Client  heap 


to  fee 

Real  TVm$- 


Semite  Help**-  jet,  the 
"•«  W from  the  filled 

ke  Per,  pities  it,  a*d 
the  method  the 
Real  Service. 


-tv.  Ztri't*  1 
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How  the  method  call  happens 


do&igThingO 


Woby 


Client  helper  packages  up  information  about  the  call 
(arguments,  method  name,  etc.)  and  ships  it  over  the 
network  to  the  service  helper. 


I Client  heap  *cfjent  t0  ^ a method«  Server  heap 


Service  helper  unpacks  the  information  from  the  client  helper, 
finds  out  which  method  to  call  (and  on  which  object)  and 
invokes  the  real  method  on  the  real  service  object. 

O heaP  ‘client  wants  t J call  a method*  ^ 
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RMI  helper  objects 


Java  RMI  gives  you  the  client  and 
service  helper  objects! 


In  Java,  RMJ  builds  the  client  and  service  helper 
objects  for  you,  and  it  even  knows  how  to  make  the 
client  helper  look  like  the  Real  Service.  In  other 
words,  RMI  knows  how  to  give  the  client  helper 
object  the  same  methods  you  want  to  call  on  the 
remote  service. 

Plus,  RMI  provides  ail  the  runtime  infrastructure  to 
make  it  work,  including  a lookup  service  so  that  the 
client  can  find  and  get  the  client  helper  (the  proxy 
for  the  Real  Service). 

With  RMI,  you  don’t  write  any  of  the  networking 
or  I/O  code  yourself.  The  client  gets  to  call  remote 
methods  (i.e.  the  ones  the  Real  Service  has)  just 
like  normal  method  calls  on  objects  running  in  the 
client's  own  local  JVM, 

Almost 

There  is  one  difference  between  RMI  calls  and  local 
(normal)  method  calls.  Remember  that  even  though 
to  the  client  it  looks  like  the  method  call  is  local, 
the  client  helper  sends  the  method  call  across  the 
network.  So  there  is  networking  and  I/O,  And  what 
do  we  know  about  networking  and  I/O  methods? 

They're  risky! 


They  throw  exceptions  all  over  the  place. 

So,  the  client  does  have  to  acknowledge  the  risk.  The 
client  has  to  acknowledge  that  when  it  calls  a remote 
method,  even  though  to  the  client  it’s  just  a local  call 
to  the  proxy/helper  object,  the  call  ultimately  involves 
Sockets  and  streams.  The  client's  original  cal]  is  local, 
but  the  proxy  turns  it  into  a mnote  call.  A remote  call 
just  means  a method  that’s  invoked  on  an  object  on 
another  JVM.  Hm  the  information  about  that  call 
gets  transferred  from  one  JVM  to  another  depends 
on  the  protocol  used  by  the  helper  objects. 

With  RMI,  you  have  a choice  of  protocols:  JRMP  or 
IIOP.  JRMP  is  RMJ's  ‘native'  protocol,  the  one  made 
just  forjava-tojava  remote  calls.  IIOP,  on  the  other 
hand,  is  the  protocol  for  COREA  (Common  Object 
Request  Broker  Architecture),  and  lets  you  make 
remote  calls  on  things  which  aren’t  necessarily  Java 
objects.  CORBA  is  usually  wmcAmore  painful  than 
RMI,  because  if  you  don't  have  Java  on  both  ends, 
there's  an  awful  lot  of  translation  and  conversion  that 
has  to  happen. 

But  thankfully,  all  we  care  about  is  Java-to-Java,  so 
we're  sticking  with  plain  old,  remarkably  easy  RMI. 


In  RMI,  the  client  helper  is  a ‘stub’ 
and  the  server  helper  is  a ‘skeleton’. 
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Making  the  Remote  Service 

This  is  an  overview  of  the  five  steps  for  making  the  remote 
service  (that  runs  on  the  server).  Don't  worry,  each  step  is 
explained  in  detail  over  the  next  few  pages. 


Step  one; 

Make  a Remote  Interface 

The  remote  interface  defines  the  methods 
that  a client  can  call  remotely.  It’s  what 
the  client  will  use  as  the  polymorphic  class 
type  for  your  service.  Both  the  Stub  and 
actual  service  will  implement  this! 


MyRemota.java 


Step  two; 

Make  a Remote  Implementation 

This  is  the  class  that  does  the  Real  Work. 
It  has  the  real  implementation  of  the 
remote  methods  defined  in  the  remote 
interface.  It's  the  object  that  the  client 


,TW  Real  Ser««.  tl34S 
swrtVi  i>»€  w'e&'xk 
l work.  It 

tke  remote  roW^te 


Step  three: 

Generate  the  stubs  and  skeletons  using  rmic 
These  are  the  client  and  server  "helpers’. 

You  don't  have  to  create  these  classes  or  ever 
look  at  the  source  code  that  generates  them. 

It's  all  handled  automatically  when  you 
run  the  rmic  tool  that  ships  with  your  Java 
development  kit. 

MyRemotefmpLSkeLclass 

Step  four; 

Start  the  RMI  registry  (rmiregistry) 

The  rmiregistry  is  like  the  white  pages  of  a 
phone  book.  It's  where  the  user  goes  to  get 
the  proxy  (the  client  siub/helper  object). 


r~Flie  Erili  Window  Help  Drink 


% rmiregistry 


1 


vur.  tv* 3 . .1 


Running  WMt  ^ ^ 

lewite  w»?le»««kW ^3  ' 

I File  Edit  Window  Help  Eai  | 


rmic  MyRemotelmpl 


"f**  ^ £he 
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MyRemotelmpl_Stub.class 
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Step  five; 

Start  the  remote  service 

You  have  to  get  the  service  object  up  and  running. 
Your  service  implementation  class  instantiates  an 
instance  of  the  service  and  registers  it  with  the  RMI 
registry.  Registering  it  makes  the  service  available  for 
clients. 


| File  Edli  Window  Help  freMerry  | 


%java  MyRemotelmpl 
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Step  one:  Make  a Remote  Interface 


Extend  java. rmi. Remote 

Remote  is  a ‘marker'  interface,  which  means  it  has  no  methods.  It  has 
special  meaning  for  RMI,  though,  so  you  must  follow  this  rule.  Notice 
that  we  say  ‘extends’  here.  One  interface  is  allowed  to  extend  another 
interface. 


public  interface  MyRemote 


Declare  that  all  methods  throw  a RemoteException 

The  remote  interface  is  the  one  the  client  uses  as  the  polymorphic  type 
for  the  service.  In  other  words,  the  client  invokes  methods  on  something 
that  implements  the  remote  interface.  That  something  is  the  stub,  of 
course,  and  since  the  stub  is  doing  networking  and  I/O,  all  kinds  of  Bad 
Things  can  happen.  The  client  has  to  acknowledge  the  risks  by  handling 
or  declaring  the  remote  exceptions.  If  the  methods  in  an  interface 
declare  exceptions,  any  code  calling  methods  on  a reference  of  that  type 
(the  interface  type)  must  handle  or  declare  the  exceptions. 

import  java . rmi . * ; 4 — ' the  Remote  interface  « •*  java 

public  interface  MyRemote  extends  Remote  { 
public  String  sayHello()  throws 

} 


MyRemote.java 


that  >t* 

i.  ft" 

remote  m«.no« 


public 


sayHello()  throws  RemoteException; 

This  return  value  is  ***  be  shipped 

Zjhtre  ftwn  , back  io 

the  d,eni  so  it  must  be  Serializable- 
hat  s how  args  and  return  values  »et 
packaged  up  and  sent  ° 


Be  sure  arguments  and  return  values  are  primitives  or  Serializable 

Arguments  and  return  values  of  a remote  method  must  be  either  primitive 
or  Serializable.  Think  about  it.  Any  argument  to  a remote  method  has  to 
be  packaged  up  and  shipped  across  the  network,  and  that’s  done  through 
Serialization.  Same  thing  with  return  values.  If  you  use  primitives,  Strings, 
and  the  majority  of  types  in  the  API  (including  arrays  and  collections), 
you’ll  be  fine.  If  you  are  passing  around  your  own  types,  just  be  sure  that 
you  make  your  classes  implement  Serializable. 


' Every  remote  method  call  is 
Considered  'risky'.  During 

©h  every 

**eihod  forces  the  client 
to  pay  attention  and 
acknowledge  that  things 
•night  not  work. 
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Step  two:  Make  a Remote  Implementation 

0 Implement  the  Remote  interface 


MyRemotelmpl.java 


Your  service  has  to  implement  the  remote  interface — the  one 
with  the  methods  your  client  is  going  to  call. 

public  class  MyRemotelmpl  extends  UnicastRemoteObject  { 

public  String  sayHello()  ^ 

return  "Server  says , 'Hey'  " ; ^5  make  sure  that 

> r^werteda,,tte"^w« 

//  more  code  in  class  x L°m  the  ,*'X'r+ ate  you  iwple*,^.  I* 

j th,s  ***>  *Ws  only  one. 


Q Extend  UnicastRemoteObject 


In  order  to  work  as  a remote  service  object,  your  object  needs  some 
functionality  related  to  ‘being  remote'.  The  simplest  way  is  to  extend 
UnicastRemoteObject  (from  the  java.rmi.server  package)  and  let  that 
class  (your  superclass)  do  the  work  for  you. 


public  class  MyRemotelmpl 


implements  My  Remote  { 


Write  a no-arg  constructor  that  declares  a RemoteException 

Your  new  superclass,  UnicastRemoteObject,  has  one  little  problem — its 
constructor  throws  a RemoteException.  The  only  way  to  deal  with  this  is 
to  declare  a constructor  for  your  remote  implementation,  just  so  that  you 
have  a place  to  declare  the  RemoteException.  Remember,  when  a class  is 
instantiated,  its  superclass  constructor  is  always  called.  If  your  superclass 
constructor  throws  an  exception,  you  have  no  choice  but  to  declare  that 
your  constructor  also  throws  an  exception. 

public  MyRemotelmpl  ( ) 


k/^\  Vou  don't  Have  to 


Register  the  service  with  the  RMI  registry 

Now  that  you’ve  got  a remote  service,  you  have  to  make  it  available  to 
remote  clients.  You  do  this  by  instantiating  it  and  putting  it  into  the  RMI 
registry  (which  must  be  running  or  this  line  of  code  fails) . When  you 
register  the  implementation  object,  the  RMI  system  actually  puts  the  stub  in 
the  registry,  since  that’s  what  the  client  really  needs.  Register  your  service 
using  the  static  rebind()  method  of  the  java.rmi.Naming  class 
try  { 

My  Remote  service  = new  MyRemotelmpl  ( ); 

Naming £ . 

} catch (Exception  ex)  { . . . J 


tan 


$we  y©w  it'rV'tei?  and 

t©  'VLm  W*  t'nd 

e RMI  ' 

sew*te  ©bjc^ 
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Step  three:  generate  stubs  and  skeletons 


^ Run  rmic  on  the  remote  implementation  class 
(not  the  remote  interface) 

The  rmic  tool,  that  comes  with  the  Java  software 
development  kit,  takes  a service  implementation  and 
creates  two  new  classes,  the  stub  and  the  skeleton. 

It  uses  a naming  convention  that  is  the  name  of 
your  remote  implementation,  with  either  _Stub  or 
.Skeleton  added  to  the  end.  There  are  other  options 
with  rmic,  including  not  generating  skeletons, 
seeing  what  the  source  code  for  these  classes  looked 
like,  and  even  using  OOP  as  the  protocol.  The  way 
we're  doing  it  here  is  the  way  you'll  usually  do  in 
The  classes  will  land  in  the  current  directory  (i.e. 
whatever  you  did  a cd  to).  Remember,  rmic  must 
be  able  to  see  your  implementation  class,  so  you'll 
probably  run  rmic  from  the  directory  where  your 
remote  implementation  is.  (We're  deliberately  not 
using  packages  here,  to  make  it  simpler.  In  the  Real 
World,  you'll  need  to  accountfor  package  directory 
structures  and  fully-qualified  names). 


Notice  that 

ot\  the  end- 


"class 


| Fite  Edil~Wtndow  Help  Whuffle  | 


%rmic  MyRemotelmpl 


- LWO  h( 

be 

help«-  objecii 


lonuDi 

id  ii«  \ 
Olid 
001  10 
Odl  01 


MvRemotelmpLStub. class 


loud*  Q 
id  no  1 

0 U A 
dot  10 

001  01 


MyRemotelmpLSkel.clasa 


Step  four:  run  rmiregistry 


(?)  Bring  up  a terminal  and  start  the  rmiregistry. 

Be  sure  you  start  it  from  a directory  that  has  access 
to  your  classes.  The  simplest  way  is  to  start  it  from 
your  ‘classes’  directory. 


| File  Edit  Window  Help  Huh?  | 


% rmiregistry 


Step  five:  start  the  service 


($)  Bring  up  another  terminal  and  start  your  service 

This  might  be  from  a main()  method  in  your  remote 
implementation  class,  or  from  a separate  launcher  class. 
In  tills  simple  example,  we  put  the  starter  code  in  die 
implementation  class,  in  a main  method  that  instantiates 
the  object  and  registers  it  with  RM3  registry. 


| flte  EdH  Window  Help  Huh?  | 


3 java  MyRemoteXmpl 
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Complete  code  for  the  server  side 


The  Remote  interface: 


import  j ava . rmi > * ; 


and  Rer;^{L£ 

^ — - v/ouv  interface  MUST 
public  interface  My  Remote  extends  Remote  { 

All  of  ye»uv  v-fimcxtc  rrUS'fc 

public  String  sayHello  ()  throws  RemoteException ; dttWe  a 


The  Remote  service  (the  implementation): 


import  java . rmi  . * ; 
import  java . rmi . server . 


public  class  My Remote Imp 1 extends  UnicastRemoteObject  implements  My  Remote  { 


public  String  sayHello () 
return  "Server  says, 

} 


, * Yo*  y v«  io  '^plcmen-fc  all  tke 

>aey'  " ■ '**?«**  of  come.  8*t 

*otite  that  do  HOT  kave  to 

declare  tke  KernoteExCeptioh. 


public  MyRamotelmpl  ( ) throws  RemoteException  { } 


public  static  void  main  (String[]  args)  { 
try  { 

MyR emote  service  = new  MyRamotelmpl ( ) ; 
Naming. rebind ("Remote  Hello”,  service); 
) catch (Exception  ox)  { 
ex.printStaekTrace () ; 


W*  svPOrddSi  Lonsbrvzh*’ 

agaves  3*  t+uyhon,  so 

you  rn«t  wvite  a Cor^truiU,  Clause  it 

that  tonsWU  u l,ti 

super  i.onst'rui'tor) 


I 


Yt,noie1ohSei^ 

wi"3  tKc  shin  Ha, 


bir^'  it  ^ the 


*“«  You  re3,st;r  It^eT^r1"*^0-  Ut 


you  are  here  ► 619 


getting  the  stub 


How  does  the  client  get  the  stub  object? 


The  client  has  to  get  the  stub  object,  since  that's  the  thing  the 
client  will  call  methods  on.  And  that's  where  the  RM1  registry 
comes  in.  The  client  does  a 'lookup',  like  going  to  the  white  pages 
of  a phone  book,  and  essentially  says,  “Here's  a name,  and  I'd  like 
the  stub  that  goes  with  that  name.” 

lookupO  is  a static  method 
ike  Nam class 

V 

My Remo to  service  = (MyRemote)  Naming . lookup ("rmi : 


]}u,  ^ iht 

b'ti  ihe  sewldp 
^3<ite y-cd  u tdcr 


//127.0.0.1/Remote  Hello") 


\ 

The  c|ieh{  always  u»«s  £),e 
r4"*0^ ! i^plcweft-btioh  a*  -the 

ty*  f tie  sct-vi tt.  I*  fati, 

rMe  client  nevev  needs  to  k*ow 

tkc  actual  class  name  of  your 
^^ot<  service- 


T 

\ V^ou  kavc  to  cast  it  to  the 
iivtcr-PaCCj  since  tkc  lookup 

method  returns  tyfC  Object 


your  host  *ame  or  |P 
address  ^ocs  here 


0 Client  does  a lookup  on  the  RMI  registry 

Naming. lookup [*rmi : //127 . 0 . 0 . l/Remota  Hello") ; 


^ RMI  registry  returns  the  stub  object 

(as  the  return  value  of  the  lookup  method)  and  RMI 
deserializes  the  stub  automatically.  You  MUST  have 
the  stub  class  (that  rmic  generated  for  you)  on  the 


(on  server) 


client  or  the  stub  won’t  be  deserialized. 


£ Client  Invokes  a method  on  the  stub,  as 
though  the  stub  IS  the  real  service 


me 

was 
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How  does  the  client  get  the  stub  class? 

Now  we  get  to  the  interesting  question.  Somehow,  someway,  the 
client  must  have  the  stub  class  (that  you  generated  earlier  using 
rmic)  at  the  time  the  client  does  the  lookup,  or  else  the  stub  won’t 
be  deserialized  on  the  client  and  the  whole  thing  blows  up.  In  a 
simple  system,  you  can  simply  hand-deliver  the  stub  class  to  the 
client 

There’s  a much  cooler  way,  though,  although  it’s  beyond  the 
scope  of  this  book.  But  just  in  case  you’re  interested,  the  cooler 
way  is  called  “dynamic  class  downloading”.  With  dynamic  class 
downloading,  a stub  object  (or  really  any  Serialized  object)  is 
‘stamped’  with  a URL  that  tells  the  RMI  system  on  the  client 
where  to  find  the  class  file  for  that  object.  Then,  in  the  process  of 
deserializing  an  object,  if  RMI  can’t  find  the  class  locally,  it  uses 
that  URL  to  do  an  HTTP  Get  to  retrieve  the  class  file.  So  you’d 
need  a simple  Web  server  to  serve  up  class  files,  and  you’d  also 
need  to  change  some  security  parameters  on  the  client.  There  are 
a few  other  tricky  issues  with  dynamic  class  downloading,  but  that’s 
the  overview. 


Complete  client  code 


import  java. rmi.*; 

public  class  MyRemoteClient  { 

public  static  void  main  ( String []  args)  { 
new  MyRemoteClient  ()  .go()  ; 


} 


public  void  go()  { 


String  s = service. sayHello () ; 


try  { 

MyRemote  service  = (MyRemote)  Naming,  lookup  ("rmi : //127 . 0 . 0 . 1/Remote  Hello"); 

7 \ 

* SVT*  IP  and  tV*  *3"* 

System. out. println (s)  fS  Wd/reWd  tV*  stv-vite 

} catch  (Exception  ex)  { like  a raula*  M n 
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RMI  class  files 


9e  sure  each  machine  has  the  class 
files  it  needs. 

The  top  three  things  programmers  do  wrong  with  RMI  are: 

1)  Forget  to  start  rm [registry  before  starting  remote  service 
{when  you  register  the  service  using  Naming.rebindQ,  the 
rmiregistry  must  be  running!) 

2)  Forget  to  make  arguments  and  return  types  serializable 
(you  won't  know  until  runtime;  this  is  not  something  the 
compiler  will  detect) 

3)  Forget  to  give  the  stub  class  to  the  client. 


daw i but  the  dlie*t  kcvc* 
re-fers  to  ike  stub  dl ass 
i*  dode^  The  elicit  always 
uses  the  YtrrcAx  mtertatCj 
as  though  the  remote 

iinter-Pade  WERE  the 
adtual  remote  objedt- 


Cllentclass  MyRemotelmpLStuhclass 
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MyRemotfcclass 
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MyRamote.daas 

Sewev  need*  both  the  Stub  a*d  Skeleto* 
dlasses,  as  well  as  the  service  a*d  the 
remote  interface-  [t  *eeds  the  sh*b  dlass 
because  remember,  the  stub  is  substituted 
^or  the  real  servide>  when  the  veal  sewide 
is  bound  to  the  RMl  registry. 
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Look  at  the  sequence  of  events  below,  and  2. 

place  them  in  the  order  in  which  they 
occur  in  a Java  RMI  application. 


An  object  on  one  heap  cannot  get  a normal  Java 
reference  to  an  object  on  a different  heap  (which  means 
running  on  a different  JVM) 

Java  Remote  Method  Invocation  (RMI)  makes  it  seem  like 
you’re  calling  a method  on  a remote  object  (l.e.  an  object 
in  a different  JVM),  but  you  aren't. 

When  a client  calls  a method  on  a remote  object,  the 
client  is  really  calling  a method  on  a proxy  of  the  remote 
object.  The  proxy  is  called  a ’stub’. 

A stub  is  a client  helper  object  that  takes  care  of  the  low- 
level  networking  details  (sockets,  streams,  serialization, 
etc.)  by  packaging  and  sending  method  calls  to  the 
server. 

To  build  a remote  service  (in  other  words,  an  object  that 
a remote  client  can  ultimately  call  methods  on),  you  must 
start  with  a remote  Interface. 

A remote  Interface  must  extend  the  Java.rmi, Remote 
Interface,  and  all  methods  must  declare 
Remote  Exception. 

Your  remote  service  implements  your  remote  interface. 


Your  remote  service  should  extend  UnicastRemoteObject. 
(Technically  there  are  other  ways  to  create  a remote  ob- 
ject but  extending  UnicastRemoteObject  is  the  simplest). 

Your  remote  service  class  must  have  a constructor, 
and  the  constructor  must  declare  a RemoteException 
(because  the  superclass  constructor  declares  one). 

Your  remote  service  must  be  instantiated,  and  the  object 
registered  with  the  RMI  registry. 

To  register  a remote  service,  use  the  static 
Naming.rebindfService  Name",  servicelnstance); 

The  RMI  registry  must  be  running  on  the  same  machine 
as  the  remote  service,  before  you  try  to  register  a remote 
object  with  the  RMI  registry. 

The  client  looks  up  your  remote  service  using  the  static 
Naming.lookup("rmi://MyHostName/ServiceName’’); 

Almost  everything  related  to  RMI  can  throw  a 
RemoteException  (checked  by  the  compiler).  This 
Includes  registering  or  looking  up  a service  in  the  reigstry, 
and  all  remote  method  calls  from  the  client  to  the  stub. 
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uses  for  RMI 


Yeah,  but  who  really  uses  RMI? 


— f We  use  it 
for  our  cool 
new  decision-support 
system. 


I heard  your  ex 


wife  still  uses 


plain  sockets 


.M 


^ I use  it 
for  serious  B-to-B,  \ 
e-commerce  back- 
ends, running  on  J2EE 
^ technology.  i 


/ 


Weve  got  an 
EJB-based  hotel 
reservation  system. 
And  EJB  uses  RMI! 


I just  can't  imagine 
life  without  our  Jini- 
enabled  home  network 
and  applicances.  ^ 


Me  too!  How  1. 
did  anyone  get 
by?  I just  love  RMI 
for  giving  us  Jini 
. technology. 


J 
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100%  Local  Combination  100%  Remote 


What  about  Servlets? 

Servlets  are  Java  programs  that  run  on  (and  with)  an  HTTP  web  server  When  a client  uses  a 
web  browser  to  interact  with  a web  page,  a request  is  sent  back  to  the  web  server.  If  the  request 
needs  the  help  of  a Java  servlet,  the  web  server  runs  (or  calls,  if  the  servlet  is  already  running) 
the  servlet  code.  Servlet  code  is  simply  code  that  runs  on  the  server,  to  do  work  as  a result  of 
whatever  the  client  requests  (for  example,  save  information  to  a text  file  or  database  on  the 
server).  If  you're  familiar  with  CGI  scripts  written  in  Perl,  you  know  exactly  what  we're  talking 
about.  Web  developers  use  CGI  scripts  or  servlets  to  do  everything  from  sending  user-submitted 
info  to  a database,  to  running  a web-site *s  discussion  board. 

And  even  servlets  can  use  EMI! 

By  far,  the  most  common  use  of  J2EE  technology  is  to  mix  servlets  and  EJBs  together,  where 
servlets  are  the  client  of  the  EJB,  And  in  that  case,  the  servlet  is  using  Rhllto  talk  to  the  EJBs* 
(Although  the  way  you  use  RMI  with  EJB  is  a link  different  from  the  process  we  just  looked  at.) 

(f)  Client  fills  out  a registration  form  and  dicks  'submit1. 

The  HTTP  server  (i.e.  web  server)  gets  the  request,  sees  that 
ft's  for  a servlet,  and  sends  the  request  to  the  servlet. 


Web  Browser 

(client)  '‘client  requests 


Web  Server 


Servlet  (Java  code)  runs,  adds  data  to  the  database, 
composes  a web  page  (with  custom  Info)  and  sends  it  back  to 
the  client  where  it  displays  in  the  browser. 


confirm,  htmf 
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very  simple  servlet 


Step  for  making  and  running  a servlet 


^ Find  out  where  your  servlets  need  to  be  placed. 

For  these  examples,  we’ll  assume  that  you  already  have  a web  server 
up  and  running,  and  that  it's  already  configured  to  support  servlets. 
The  most  important  thing  is  to  find  out  exactly  where  your  servlet 
class  files  have  to  be  placed  in  order  for  your  server  to  ‘see’  them.  If 
you  have  a web  site  hosted  by  an  ISP,  the  hosting  service  can  tell  you 
where  to  put  your  servlets,  just  as  they’ll  tell  you  where  to  place  your 
CGI  scripts. 


(^)  Set  the  servletsjar  and  odd  it  to  your  classpath 

Servlets  aren’t  part  of  the  standard  Java  libraries;  you  need 
the  servlets  classes  packaged  into  the  servletsjar  file.  You  can 
download  the  servlets  classes  fromjava.sun.com,  or  you  can  get 
them  from  yourjava-enabled  web  server  {like  Apache  Tomcat,  at 
the  apache.org  site).  Without  these  classes,  you  won't  be  able  to 
compile  your  servlets. 

(§)  Write  c servlet  doss  by  extending  HttpServlet 

A servlet  is  just  a Java  class  that  extends  HttpServlet  (from  the 
javax.servlet.http  package).  There  are  other  types  of  servlets  you 
can  make,  but  most  of  the  time  we  care  only  about  HttpServlet. 

public  class  MyServletA  extends  HttpServlet  { ...  } 


( ?)  Write  on  HTML  page  that  invokes  your  servlet 

When  the  user  dicks  a link  that  references  your  servlet,  the  web 
server  will  find  the  servlet  and  invoke  die  appropriate  method 
depending  on  the  HTTP  command  (GET,  POST,  etc.) 

<a  href="servlets/MyServletA">This  ia  the  moat  amazing 


(S)  Moke  your  servlet  and  HTML  page  available  to  your  server 

This  is  completely  dependent  on  your  web  server  (and  more  specifi- 
cally, on  which  version  of  Java  Servlets  that  youTe  using).  Your  ISP 
may  simply  tell  you  to  drop  it  into  a ‘‘Servlets”  directory  on  your 
web  site.  But  if  you’re  using,  say,  the  latest  version  of  Tomcat,  you’ll 
have  a lot  more  work  to  do  to  get  the  servlet  (and  web  page)  into 
the  right  location.  (We  just  happen  to  have  a book  on  this  too  .) 


a 

servletsjar 
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Duml^tJuestiPns 


BULLET  POINTS  

■ Servlets  are  Java  classes  that  run  entirely  on 
(and/or  within)  an  HTTP  (web)  server. 

■ Servlets  are  useful  for  running  code  on  the 
server  as  a result  of  client  interaction  with  a 
web  page.  For  example,  if  a client  submits 
information  in  a web  page  form,  the  servlet  can 
process  the  information,  add  it  to  a database, 
and  send  back  a customized,  confirmation 
response  page. 

■ To  compile  a servlet,  you  need  the  servlet 
packages  which  are  in  the  servlets.jar  file.  The 
servlet  classes  are  not  part  of  the  Java  standard 
libraries,  so  you  need  to  download  the  servlets, 
jar  from  java.sun.com  or  get  them  from  a servlet- 
capable  web  server.  (Note:  the  Servlet  library 

is  included  with  the  Java  2 Enterprise  Edition 
(J2EE)) 

■ To  run  a servlet,  you  must  have  a web  server 
capable  of  running  servlets,  such  as  the  Tomcat 
server  from  apache.org. 

■ Your  servlet  must  be  placed  in  a location  that's 
specific  to  your  particular  web  server,  so  you’ll 
need  to  find  that  out  before  you  try  to  run  your 
servlets.  If  you  have  a web  site  hosted  by  an  ISP 
that  supports  servlets,  the  ISP  will  tell  you  which 
directory  to  place  your  servlets  in. 

■ A typical  servlet  extends  HttpServlet  and 
overrides  one  or  more  servlet  methods,  such  as 
doGet()  or  doPost(). 

■ The  web  server  starts  the  servlet  and  calls  the 
appropriate  method  (doGet(),  etc.)  based  on  the 
client's  request. 

■ The  servlet  can  send  back  a response  by  getting 
a PrintWriter  output  stream  from  the  response 
parameter  of  the  doGet()  method. 

■ The  servlet  'writes’  out  an  HTML  page,  complete 
with  tags). 


What's  a JSP,  and  how  does  it  relate  to  servlets? 


A- 

JSP  stands  for  Java  Server  Pages.  In  the  end,  the  web  server 
turns  a JSP  into  a servlet,  but  the  difference  between  a servlet  and 
a JSP  is  what  YOU  (the  developer)  actually  create.  With  a servlet, 
you  write  a Java  class  that  contains  HTML  in  the  output  statements 
(if  you're  sending  back  an  HTML  page  to  the  client).  But  with  a 
JSP,  it's  the  opposite — you  write  an  HTML  page  that  contains  Java 
code! 

This  gives  you  the  ability  to  have  dynamic  web  pages  where  you 
write  the  page  as  a normal  HTML  page,  except  you  embed  Java 
code  (and  other  tags  that  "trigger"  Java  code  at  runtime)  that 
gets  processed  at  runtime.  In  other  words,  part  of  the  page  is 
customized  at  runtime  when  the  Java  code  runs. 

The  main  benefit  of  JSP  over  regular  servlets  is  that  it's  just  a lot 
easier  to  write  the  HTML  part  of  a servlet  as  a JSP  page  than  to 
write  HTML  in  the  torturous  print  out  statements  in  the  servlet's 
response.  Imagine  a reasonably  complex  HTML  page,  and  now 
imagine  formatting  it  within  println  statements.  Yikes! 

But  for  many  applications,  it  isn't  necessary  to  use  JSPs  because 
the  servlet  doesn't  need  to  send  a dynamic  response,  or  the 
HTML  is  simple  enough  not  to  be  such  a big  pain.  And,  there  are 
still  many  web  servers  out  there  that  support  servlets  but  do  not 
support  JSPs,  so  you're  stuck. 

Another  benefit  of  JSPs  is  that  you  can  separate  the  work  by 
having  the  Java  developers  write  the  servlets  and  the  web  page 
developers  write  the  JSPs. That's  the  promised  benefit,  anyway. 

In  reality,  there's  still  a Java  learning  curve  (and  a tag  learning 
curve)  for  anyone  writing  a JSP,  so  to  think  that  an  HTML  web  page 
designer  can  bang  out  JSPs  is  not  realistic.  Well,  not  without  tools. 
But  that's  the  good  news— authoring  tools  are  starting  to  appear, 
that  help  web  page  designers  create  JSPs  without  writing  the 
code  from  scratch. 


1$  this  all  you're  gonna  say  about  servlets?  After  such  a 
huge  thing  on  RMI? 


A- 

^r\-  Yes.  RMI  is  part  of  the  Java  language,  and  all  the  classes  for 
RMI  are  in  the  standard  libraries.  Servlets  and  JSPs  are  not  part  of 
the  Java  language;  they're  considered  standard  extensions.  You 
can  run  RMI  on  any  modern  JVM,  but  Servlets  and  JSPs  require  a 
properly  configured  web  server  with  a servlet  "container"  This  is 
our  way  of  saying, "it's  beyond  the  scope  of  this  book."  But  you  can 
read  much  more  in  the  lovely  Head  First  Servlets  & JSP. 
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Just  for  fun,  let's  make  the  Phrase-O-Matic 
work  as  a servlet 

Now  that  we  told  you  that  we  won't 
say  any  more  about  servlets,  we  can’t 
resist  servleuzing  (yes,  we  can  verbify 
it)  the  Phrase-O-Matic  from  chapter  1. 

A servlet  is  still  justjava.  And  Java  code 
can  call  Java  code  from  other  classes. 

So  a servlet  is  free  to  call  a method  on 
the  Phrase-O-Matic.  Ail  you  have  to  do 
is  drop  the  Phrase-O-Matic  class  into 
the  same  directory  as  your  servlet,  and 
you’re  in  business.  (The  Phrase-O- 
Matic  code  is  on  the  next  page) . 


Import  java.io.*; 

import  javax. servlet ; 
import  javax. servlet . http . * ; 

public  class  KathyServlet  extends  HttpServlet  ( 

public  void  do Get  (HttpServletRequest  request , HttpServletResponse  response) 

throws  ServletException,  XOException  { 

String  title  = "PhraseOMatic  has  generated  the  following  phrase."; 

response. setContentType ("text/html") ; 

PrintWriter  out  = response. getWriter () ; 

out . println  ("<HTMLXHEADXTITLE>" ) ; . £«?  Y°w  ^ 

out  .println  r'Ph^^aeOaatio'r)  ; S'  ano^«*"  n o£  the 

out. println <"</TITLEX/HZADXBODY>")  ; v X rtatt  maker™-**  1 p3#,e) 

out. println r<Hl>"  + title  + "</Hl>")  ; Y t'a“  tori  W 

out. println ("<P>"  + PhraseOMatic .makePhrasa 0 ) ; 

out. println  ("<PXa  href=\/,KathyServlet\">make  another  phrase</aX/p>")  ; 
out  .println  ("</BODYX/HTML>")  ; 

out. close  0 ; 

) 

) 
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Phrase-O-Matic  code 


Phrase-O-Matic  code,  servlct-f  ricwdly 

This  is  a slightly  different  version  from  the  code  in  chapter  one.  In  the 
original,  we  ran  the  entire  thing  in  a main()  method,  and  we  had  to  rerun 
the  program  each  time  to  generate  a new  phrase  at  the  command-line.  In  this 
version,  the  code  simply  returns  a String  (with  the  phrase)  when  you  invoke 
the  static  makePhrase()  method.  That  way,  you  can  call  the  method  from  any 
other  code  and  get  back  a String  with  the  randomly-composed  phrase. 

Please  note  that  these  long  String!’]  array  assignments  are  a victim  of  word- 
processing here — don’t  type  in  the  hyphens!  Just  keep  on  typing  and  let  your 
code  editor  do  the  wrapping.  And  whatever  you  do,  don’t  hit  the  return  key  in 
the  middle  of  a String  (i.e.  something  between  double  quotes). 


public  class  PhraseOMatic  { 

public  static  String  makePhrase()  { 

//  make  three  sets  of  words  to  choose  from 

String [ ] wordListOne  = {"24/7","multi-Tier","30,000  foot" ,"B-to-B" , "win-win" , "front- 
end"  , "web-based" , "pervasive" , "smart" , "six-sigma" , "critical -path" , "dynamic" } ; 

String []  wordListTwo  = { "empowered" , "sticky",  "valued- added" , "oriented",  "centric" 
"distributed",  "clustered",  "branded" , "outside -the -box" , "positioned",  "networked",  "fo- 
cused", "leveraged",  "aligned",  "targeted",  "shared",  "cooperative",  "accelerated"}; 

String []  wordListThree  = {"process",  "tipping  point",  "solution",  "architecture", 
"core  competency",  "strategy",  "mindshare",  "portal",  "space",  "vision",  "paradigm",  "mis- 
sion" } ; 

//  find  out  how  many  words  are  in  each  list 
int  oneLength  = wordListOne. length; 
int  twoLength  = wordListTwo . length; 
int  threeLength  = wordListThree . length; 

//  generate  three  random  numbers,  to  pull  random  words  from  each  list 

int  randl  = (int)  (Math . random ( ) * oneLength); 

int  rand2  = (int)  (Math . random ( ) * twoLength); 

int  rand3  = (int)  (Math . random ( ) * threeLength) ; 

//  now  build  a phrase 

String  phrase  = wordListOne [randl]  + " " + wordListTwo [rand2]  + " " + 
wordListThree [rand3] ; 

//  now  return  it 

return  ("What  we  need  is  a " + phrase) ; 

} 

} 
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Enterprise  JavaPeans:  RMI  on  steroids 

RMI  is  great  for  writing  and  running  remote  services.  But 
you  wouldn't  run  something  like  an  Amazon  or  eBay  on  RMI 
alone.  For  a large,  deadly  serious,  enterprise  application,  you 
need  something  more.  You  need  something  that  can  handle 
transactions,  heavy  concurrency  issues  (like  a gazillion 
people  are  hitting  your  server  at  once  to  buy  those  organic 
dog  kibbles),  security  (not  just  anyone  should  hit  your 
payroll  database),  and  data  management.  For  that,  you  need 
an  enterprise  application  server. 

In  Java,  that  means  a Java  2 Enterprise  Edition  (J2EE)  server. 
AJ2EE  server  includes  both  a web  server  and  an  Enterprise 
JavaBeans(EJB)  server,  so  that  you  can  deploy  an  application 
that  includes  both  servlets  and  EJBs.  Like  servlets,  EJB  is 
way  beyond  the  scope  of  this  book,  and  there’s  no  way  to 
show  "just  a little”  EJB  example  with  code,  but  we  will  take 
a quick  look  at  how  it  works.  (For  a much  more  detailed 
treatment  of  EJB,  we  can  recommend  the  lively  Head  First 
EJB  certification  study  guide.) 


An  EjB  server  adds  a bunch 
of  services  that  you  don't  get 
wifh  straight  RMI.  Things 
like  transactions,  security, 
concurrency,  database 
management,  and  networking. 

An  E JB  server  steps  into  -die 
middle  of  an  RMI  call  and 
layers  in  all  of  die  services. 
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This  is  only  a small  part  of  the  EJB  picture1 
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For  our  final  trick...  a little  Jini 


We  love  Jini.  We  think  Jini  is  pretty  much  the  best  thing  in  Java.  If  EJB  is  RMI 
on  steroids  (with  a bunch  of  managers),  Jini  is  RMI  with  wings.  Pure  Java  bliss. 

Like  the  EJB  material,  we  can't  get  into  any  of  the  Jini  details  here,  but  if  you 
know  RMI,  you're  three-quarters  of  the  way  there.  In  terms  of  technology, 
anyway.  In  terms  of  mindset , it's  time  to  make  a big  leap.  No,  itls  time  to  fly. 

Jini  uses  RMI  (although  other  protocols  can  be  involved),  but  gives  you  a few 
key  features  including: 

Adaptive  discovery 

Self-healing  networks 

With  RMI,  remember,  the  client  has  to  know  the 
name  and  location  of  the  remote  service.  The 
client  code  for  the  lookup  includes  the  IP  address  or 
hostname  of  the  remote  service  (because  that's  where 
the  RMI  registry  is  running)  and  the  logical  name  the 
service  was  registered  under. 

But  with  Jini,  the  client  has  to  know  only  one  thing:  the 
interface  implemented  by  the  service.1  That's  it. 

So  how  do  you  find  things?  The  trick  revolves  around  Jini  lookup 
services.  Jini  lookup  services  are  far  more  powerful  and  flexible  than 
the  RMI  registry.  For  one  tiling,  Jini  lookup  services  announce  themselves  to  the 
network,  automatically.  When  a lookup  service  comes  online,  it  sends  a message  (using  IP 
multicast)  out  to  the  network  saving,  Tm  here,  if  anyone's  interested.” 


But  that’s  notail.  Let's  say  you  (a  client)  come  online  afterxhe  lookup  service  has  already 
announced  itself,  you  can  send  a message  to  die  entire  network  saying,  "Are  there  any 
lookup  services  out  there?” 


Except  that  you're  not  really  interested  in  the  lookup  service  itself— you're  interested  in 
the  services  that  are  registered  \vi\h  the  lookup  service.  Things  like  RMI  remote  services, 
other  serializable  Java  objects,  and  even  devices  such  as  printers,  cameras,  and  coffee- 
makers. 


And  here's  where  it  gets  even  more  fun:  when  a service  conies  online,  it  will  dynamically 
discover  (and  register  itself  with)  any  Jini  lookup  services  on  the  network.  When  the 
service  registers  with  the  lookup  service,  the  service  sends  a serialized  object  to  be  placed 
in  the  lookup  service.  That  serialized  object  can  be  a stub  to  an  RMI  remote  service,  a 
driver  for  a networked  device,  or  even  the  whole  service  itself  that  (once  you  get  it  from 
the  lookup  service)  runs  locally  on  your  machine.  And  instead  of  registering  by  name , the 
service  registers  by  the  interface  it  implements. 

Once  you  (the  client)  have  a reference  to  a lookup  service,  you  can  say  to  that  lookup 
service,  "Hey  do  you  have  anything  that  implements  ScientificCalculator?”  At  that  point, 
the  lookup  service  will  check  its  list  of  registered  interfaces,  and  assuming  it  finds  a 
match,  says  back  to  you,  “Yes  I da  have  something  that  implements  that  interface.  Here's 
the  serialized  object  the  ScientificCalculator  service  registered  with  me.” 
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^ Jini  lookup  service  is  launched  somewhere  on  the  network,  and 
announces  itself  using  IP  multicast. 


machine  on  the  network 
somewhere... 


another  machine  on  the  network 


another  machine  on  the  network 


An  already-running  Jini  service  on 
another  machine  asks  to  be  registered 
with  this  newly-announced  lookup 
service.  It  registers  by  capability, 
rather  than  by  name.  In  other  words, 
it  registers  as  the  service  interface  it 
implements.  It  sends  a serialized  object 
to  be  placed  in  the  lookup  service. 


another  machine  on  the  network 


machine  on  the  network 
somewhere.. . 


another  machine  on  the  network 
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Adaptive  discovery  in  action,  continued... 

(5)  A client  on  the  network  wonts 
something  that  implements  the 
ScientificColculator  interface.  It  has 
no  idea  where  (or  if)  that  thing  exists, 


somewhere... 


The  lookup  service  responds,  since  it  does  hove  something 
registered  as  a ScientificCalculator  interface. 
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Self-healing  network  in  action 

© A Jini  Service  has  asked  to  register  with  the  lookup  service.  The  lookup 
service  responds  with  a “lease".  The  newly-registered  service  must  keep 
renewing  the  lease,  or  the  lookup  service  assumes  the  service  has  gone 
offline.  The  lookup  service  wants  always  to  present  an  accurate  picture 
to  the  rest  of  the  network  about  which  services  are  available. 


(2)  The  service  goes  off  line  (somebody  shuts  it  down),  so  it  fails  to 
renew  its  lease  with  the  lookup  service.  The  lookup  servic&  drops  it. 


another  machine  on  the  network 


machine  on  the  network 
somewhere... 
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Final  Project:  the  Universal  Service  browser 

We’re  going  to  make  something  that  isn’t  Jini-enabled,  but  quite  easily  could  be. 

It  will  give  you  the  flavor  and  feeling  of  jini,  but  using  straight  RMI.  In  fact  the 
main  difference  between  our  application  and  ajini  application  is  how  the  service  is 
discovered.  Instead  of  thejini  lookup  service,  which  automatically  announces  itself  and 
lives  anywhere  on  the  network,  we’re  using  the  RMI  registry  which  must  be  on  the  same 
machine  as  the  remote  service,  and  which  does  not  announce  itself  automatically. 

And  instead  of  our  service  registering  itself  automatically  with  the  lookup  service,  we 
have  to  register  it  in  the  RMI  registry  (using  Naming, rebind()). 

But  once  the  client  has  found  the  service  in  the  RMI  registry,  the  rest  of  the  application 
is  almost  identical  to  the  way  we’d  do  it  in  Jini.  (The  main  thing  missing  is  the  lease  that 
would  let  us  have  a self-healing  network  if  any  of  the  services  go  down.) 

The  universal  service  browser  is  Like  a specialized  web  browser,  except  instead  of  HTML 
pages,  the  service  browser  downloads  and  displays  interactive  Java  GUIs  that  we’re 
calling  universal  services. 
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How  it  works: 


Client  starts  up  and 
does  a lookup  on  the 
RMI  registry  for 
the  service  called 
"ServiceServer",  and 
gets  back  the  stub. 


Service  Browser 
(client) 


RMI  registry  (on  server) 


Client  calls  getServiceList()  on  the  stub.  The  ServiceServer 
returns  an  array  of  services 

Service  Browser  Sewer 

(client)  - “9etScrvic®List0“ 


“OK,  here's  an  array  of  services" 


^ Client  displays  the  list  of  services  in  a GUI 


Service  Browser 
(client) 


Server 
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How  it  works,  continued... 


0 User  selects  from  the  list,  so  client  colls  the  getServiceO 
method  on  the  remote  service.  The  remote  service  returns  a 
serialized  object  that  is  an  actual  service  that  will  run  inside 
the  client  browser. 


£ Client  calls  the  getGuiPanel()  on  the  serialized  service  object  it 
just  got  from  the  remote  service.  The  GUI  for  that  service  is 
displayed  inside  the  browser,  and  the  user  can  interact  with  it 
locally.  At  this  point,  we  don’t  need  the  remote  service  unless/until 
the  user  decides  to  select  another  service. 


Service  Browser 
(client) 
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The  classes  and  interfaces: 


^ interface  ServieeServer  implements  Remote 

A regular  old  RMI  remote  interface  for  the  remote  service  (the 
remote  service  has  the  method  for  getting  the  service  list  and 
returning  a selected  service). 

class  ServiceServerlmpI  implements  ServieeServer 

The  actual  RMI  remote  service  (extends  Unicas+RemoteObject). 
Its  job  is  to  instantiate  and  store  all  the  services  (the  things 
that  will  be  shipped  to  the  client),  and  register  the  server  itself 
(ServiceServerlmpI)  with  the  RMI  registry. 


ServieeServer 

getServicasListQ 

getServIcaO 


i 

ServiceServerlmpI 

gefServicesListO 

getServiceO 


(j|D  class  Service  Browser 

The  client.  It  builds  a very  simple  GUI,  does  a lookup  in  the  RMI 
registry  to  get  the  ServieeServer  stub,  then  calls  a remote  method  on 
it  to  get  the  list  of  services  to  display  in  the  GUI  list. 


ServIceBrowser 

mainO 


(H)  interface  Service 

This  is  the  key  to  everything.  This  very  simple  interf  ace  has  just  one 
method,  get&uiPanelO.  Every  service  that  gets  shipped  over  to  the 
client  mast  implement  this  interface.  This  is  what  makes  the  whole  thing 
UNIVERSAL!  By  implementing  this  interface,  a service  can  come  over 
even  though  the  client  has  no  idea  what  the  actual  class  (or  classes) 
are  that  make  up  that  service.  All  the  client  knows  is  that  whatever 
comes  over,  it  implements  the  Service  interface,  so  it  MUST  have  a 
getGuiPanelQ  method. 

The  client  gets  a serialized  object  as  a result  of  calling 
getService(selectedSvc)  on  the  ServieeServer  stub,  and  all  the  client 
says  to  that  object  is,  "I  don't  know  who  or  what  you  are,  but  I bO 
know  that  you  implement  the  Service  interface,  so  I know  I can  calf 
getGufPanel()  on  you.  And  since  getGuiPanelQ  returns  a JPanel,  Til  just 
slap  it  into  the  browser  GUI  and  start  interacting  with  itl 


Service 

getGuiPaneiQ 


(g)  class  DiceService  implements  Service 

Got  dice?  If  not,  but  you  need  some,  use  this  service  to  roll  anywhere 
from  1 to  6 virtual  dice  for  you. 

class  MiniMusicService  implements  Service 

Remember  that  fabulous  little  'music  video'  program  from  the  first 
GUI  Code  Kitchen?  We've  turned  it  into  a service , and  you  can  play  it 
over  and  over  and  over  until  your  roommates  finally  leave. 


/ DiceService 
/ gelGulPanelO 


DayOfTheWeekServIce  I 
getGuiPanelf) 


i 

MiniMusicService 

gelGulPanelO 


class  bayOfTheWeekServtce  implements  Service 

Were  you  born  on  a Friday?  Type  in  your  birthday  and  find  out. 
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interface  ServiceServer  (the  remote  interface) 

import  java.rmi.*; 

public  interface  ServiceServer  extends  Remote  { 

Object []  getServiceList ()  throws  RemoteException; 

Service  getService (Ob ject  serviceKey)  throws  RemoteException; 


interface  Service  (what  the  Gill  services  implement) 


in$>ort  javax. swing.* ; 
import  java.io.*; 

public  interface  Service  extends  Serializable  { 
public  JPanel  getGuiPanel () ; 

} 
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class  ServiceServerlmpI  (the  remote  Implementation) 


>ort  java.rmi.*; 
ia^ort  java.util.*; 
u^ort  j ava . rmi . server . 


„a\  RMl 


5lic  class  ServiceServerlmpI  extends  0nicastRemoteObject  implements  ServiceServer  { 
HashMap  sarvicaList;  s«vvi£es  *;/[  l,  i , . 

public  ServiceServerlmpI ()  throws  RemoteRxception  { 

setUpSarvicaa  ()  ; i.\ 

> , u,  ii  «U€<ii  '^l^tCeciM, 


CP  ■,«£*,g'a' 


private  void  setUpServices ()  { -lV^sal  s£^’ltcs 

serviceList  = new  HashMap  (); 

serviceList.put  ("Dice  Rolling  Service",  new  DiceService  () ) ; 
serviceList.put ("Day  of  the  Week  Service",  new  DayOfTheWeekServiee  () ) ; 
serviceList. put ("Visual  Music  Service",  new  MiniMusicService () ) ; ... 

i K.  /y  /ll,  atti*al  ter**" 

public  Object!]  gatServiceList ()  { Client  £j||s  it-  ■ 

System. out. println  ("in  remote")  ; dirpbv  in  u 9^  3 ^ o(  twit,,  X 

return  serviceList.kaySatO  . toArray  ()  ; Jd  * ^ ^ ^ ««■  «*  seledt  o«Ae 

) ‘“'de)  ty  JLj  an^tnJ^  V*  h* 

,h  ^ taiH/Vfo p.  ^ won'/  a ^7  ^3^  3f  e 

public  Service  getService (Object  serviceKey)  throws  RemoteRxception  { 

Service  theService  = (Service)  serviceList .get (serviceKey) ; ^ 

return  th.S.rvio.; 

^yo»»  t)vc  7'  ^ \\jis  l°&1  wSC4,  ^ J.  /v.e  torriS?^1^ 

ar^'W  ri 

jtvv'ite 


return  theServioe; 


public  static  void  main  (String []  args)  { 
try  { 

Naming,  rebind  (v' Service  Server  " , new  ServiceServerlmpI ()) ; 
) catch (Exception  ex)  ( 
ex  .prints taclcTrace  ()  ; 

} 

System. out. print In ("Remote  service  is  running") 
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ServiceBrowser  code 


class  ServiceBrowser  (the  client) 


import  java.awt.*; 
isnpozt  javax . swin g . * ; 
import  java.rmi.*; 
import  java. awt .event.*; 


public  class  ServicaBrowaer  { 

JPanel  main Panel ; 

JComboBox  serviceLi Sty- 
Service  Server  server; 


public  void  buildGUIO  { 

JFrame  frame  = new  JFrame("RMI  Browser")  ; 
mainPanel  =>  new  JPanel  (); 
frame  . getCon tent Pane  ()  * add  {Border  Layout , CENTER , mainPanel)  ; 


(.  .„au  oi  Ofeieits)  to  tVii 
Add  tte  ux^tes  3*  kw>ws  Ho*  to 

1">T 


Qbject[]  services  = getServicesList () 


serviceList  = new  JComboBox (services) 


frame . getCon tentPane  ( ) . add  (BorderLayout . NORTH , serviceList)  ; 


serviceList.  addActionL is tener  (new  MyLis tListenar  () ) ; 

frame > setSize (500 , 500)  ; 
frame . satVi sible  (true)  ; 


) 


void  loadSexvice (Object  serviceSelection)  ( 
try  { 

Service  svc  = server . getService (serviceSelection) 


ramovaAll  ()  ; the  itiusl  servile  1-  1l,  C\ //  r i 

add(sva  .getSuiPanal  () ) ; . f'  a$  Retied  o*e.  fThii  **0*4  js  u\\,j  i 1, 
validate  ()  ; [liW  oh  ^ J Co^Sovd.  * .^e 

ttrt  J Xtx  f-  it 


xnainPanel . removeAll  ( ) 
mainPanel . 
mainPanel . 
mainPanel . repaint ( ) ; 
catch (Exception  ex)  ( 
ex .prints tackTrace () 


I'iScr^tLisiO).  lie  ” J.  “T  ^ "e  ^led 
(tvnaii-ud),  whi4ll . auio^OultT  ***,  ath1l  ie™‘U 

* ^ t>  jp^d  ^ £ b a,,d  add 
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Object []  getServicesList ()  { 

Object  obj  = null; 

Object []  services  = null; 

try  { 


>r 


.y*  RMI  *4  3* ****** 


obj  = Naming. lookup ("rmi : //127. 0. 0. 1/ServiceServer") ; 


} 

catch (Exception  ex)  { 
ex.printStackTraceO  ; 

server  = (ServiceServer)  obj; 


try  { 

services  = server .getServiceList {) 

} catch (Exception  ex)  { 
ex.printStackTraceO  ; 

} 

return  services; 


?etScrvideL.istO  jives  us  the  array  Objedtsj 

hat  we  display  m the  JComboBo*  -for  the  user  to 
seledt  -from. 


} 


class  MyListListener  implements  ActionListener  { 
public  void  actionPerf ormed  (ActionEvent  ev)  { 

Object  selection  = serviceList .getSelectedItem() 
loadService (selection) ; 


ade  a 


) 


public  static  void  main (String []  args) 
new  ServiceBrowser () .buildGUl () ; 

} 
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DiceService  code 


class  DiceService  (a  universal  service,  implements  Service) 


Import  javax . swing. * ; 
import  java ,awt. event .* ; 
import  java.io.*; 

public  class  DiceService  implements  Service  { 

JLabel  label; 

JComboBox  numOfDice; 


public  vJPanel  ge tGui Panel  ()  { 

JPanel  panel  = new  JPanel () ; 

JButton  button  = new  JButton ("Roll  'em!”); 
String []  choices  = ("1”,  "2",  "3",  "4”,  "5”); 
numOfDice  = new  JComboBox  (choices)  ; 
label  = new  Jhabel  ("dice  values  here”); 
button . addActionListener (new  RollEmLiatener () ) 
panel  * add  (numOfDice)  ; $ert% 


AMI  Browner 

DKtftolUn?  Service 

a 

panel . add (button) ; 
panel. add (label) ; 
return  panel; 


c£|r“  the.  , r ,, 

We  the  ^ 


) 


public  class  RollEmListener  implements  Actionhistener  { 
public  void  actionPer formed (ActionEvent  ev)  ( 

//  roll  the  dice 
String  diceOutput  = " " ; 

String  selection  = (String)  numOfDice > getSelectedltem ( ) ; 
int  numOfDiceToRoll  = Integer .parselnt (selection) ; 
for  (int  i = 0;  i < numOfDiceToRoll;  i-H-)  ( 

int  r = (int)  ( (Math. random ()  * 6)  + 1) ; 
diceOutput  +=  ("  " + r) ; 

> 

label . setTaxt  (diceOutput)  ; 


tki.  stwiit  is  S'ttsds'ril^Vly"4'1 9""*  Ul1  “k«” 

» tt.  iio  hti  /or  “■  *>  <***««>• » 


} 

} 


your  pencil 


Think  about  ways  to  improve  the  DiceService.  One 
suggestion:  using  what  you  learned  In  the  GUI  chapters, 
make  the  dice  graphical.  Use  a rectangle,  and  draw  the 
appropriate  number  of  circles  on  each  one,  corresponding 
to  the  roll  for  that  particular  die. 
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class  MlnlMusicService  (a  universal  service,  implements  Service) 


JButton  playltButton  = nsw  JButton ("Play  it")  ; 
playltButton . addActioiiListaner (nsw  PlayltListaner () ) ; 
mainPanei . add (my Panel) ; 
mainP artel . add  (playltButton)  ; 
return  main Panel; 

} 

public  class  PlayltListener  implements  Ac tionLis tenor  { "This  i s all  -the  ^usit  sbt((  il. 
public  void  actionPerformed  (ActionEvent  ev)  { Cede  K'itzke*  in  ehafter  il,  so  we 

won't  annotate  it  JUir.  here. 

try  { ^ 

Sequencer  sequencer  = MidiSystem. getSequencer  ()  ; 
sequencer , open ( ) ; 

sequencer. addCon trollerBventld a toner  (myPanel , new  int[]  (127)); 

Sequence  seq  = new  Sequence (Sequence . PPQ,  4); 

Track  track  = aeq. creataTrack() ; 

for  (int  1=0;  i < 100;  i+=  4)  { 

int  rNum  = (Int)  ( (Math,  random ()  * 50)  + 1)  ; 

if  (rNum  < 38)  { //  so  now  only  do  it  if  num  <38  (75%  of  the  time) 
track. add (makeEvent (144 , 1 ,rNum, 100, i) ) ; 
track . add (makeEvent  (176 , 1 , 127,0,1) ) ; 
track . add (makeEvent  (128 , 1 ,rNumy  100 , i + 2)); 

} 

) //  end  loop 

sequencer . setSequence ( seq) ; 
sequencer .start () ; 
sequencer. setTempolnBPM( 2 20) ; 

) catch  (Exception  ex)  (ex. prints tackTrace () ; } 


) //  close  actionperforned 
) //  close  inner  class 
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class  MiniMusicService,  continued... 

public  MidiEvent  makeEvent (int  comd,  int  chan,  int  one,  int  two,  int  tick)  { 
Midi Event  event  = null; 
try  { 

ShortMessage  a = new  ShortMessage () ; 
a. setMessage (comd,  chan,  one,  two) ; 
event  = new  MidiEvent (a,  tick) ; 

} catch (Exception  e)  { } 
return  event; 

} 


class  MyDrawPanel  extends  JPanel  implements  ControllerEventListener  { 

//  only  if  we  got  an  event  do  we  want  to  paint 
boolean  msg  = falser- 

public  void  con trolChange (ShortMessage  event)  { 
msg  = true; 
repaint ( ) ; 


public  Dimension  getPreferredSize ()  { 
return  new  Dimension (300, 300) ; 

} 

public  void  paintComponent (Graphics  g)  { 
if  (msg)  { 

Graphics2D  g2  = (Graphics2D)  g; 

int  r = (int)  (Math. random ()  * 250); 
int  gr  = (int)  (Math . random ()  * 250); 
int  b = (int)  (Math . random ( ) * 250); 

g.setColor (new  Color (r,gr,b) ) ; 

int  ht  = (int)  ( (Math . random ( ) * 120)  + 10); 
int  width  = (int)  ( (Math . random ( ) * 120)  + 10); 

int  x = (int)  ( (Math . random ( ) * 40)  + 10); 
int  y = (int)  ( (Math . random ( ) * 40)  + 10); 

g . fillRect  (x , y , ht , width)  ; 
msg  = false; 

} //  close  if 
} //  close  method 
} //  close  inner  class 

} //  close  class 


ec»  '*  T 
$ 7°*  tode 


R4fi 
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class  DayOfTheWeekService  (a  universal  service,  Implements  Service) 


import  javax . swing . * ; 
import  java . awt . event .* ; 
import  java . awt . * ; 
import  java.io.*; 
import  java. util.*; 
inport  java. text. *; 

public  class  DayOfTheWeekService  implements  Service  { 


JLabel  outputLabel; 
jComboBox  month; 
JTextField  day; 
JTextField  year; 


public  JPanel  getGuiPanel ()  ( 

JPanel  panel  = new  JPanel  () ; 

JButton  button  = new  JButton("Do  it!"); 

button. addActionListener (new  DoItListener () ) ; 

outputLabel  = new  JLabel ("date  appears  here") ; 

DateFormatSymbols  date Stuff  = new  DateFormatSymbols ( ) ; 

month  - new  JComboBox (dates tuff . getMonths ()) ; 

day  = new  JTextField (8) ; 

year  = new  JTextField (fl) ; 

JPanel  inputPanel  = new  JPanel (new  GridLayout (3 ,2) ) ; 

input Panel. add (new  JLabel ("Month") ) ; 

inputPanel. add (month) ; 

inputPanel . add (new  JLabel ( "Day" ) ) ; 

inputPanel . add (day) ; 

inputPanel . add (new  JLabel ( "Year" ) ) ; 

inputPanel . add (year) ; 

panel . add (inputPanel)  ; 

panel . add (button) ; 

panel. add (outputLabel) ; 

return  panel; 


} 


public  class  DoItListener  implements  AetionListenar  { 
public  void  aa  tionPer  formed  (Ac  tionEvent  ev)  ( 
int  monthNum  - month  .getSelectedlndex  ()  ; 
int  dayNum  “ Integer .par selnt (day . getText{) ) ; 
int  yearNum  = Integer .parselnt (year . getTaxt () ) 
Calendar  o - Calendar .get Instance () ; 
c > sot  (Calendar . MONTH , monthNum)  ; 
c . set (Calendar . DAY_OF_MONTH ; day Mum) ; 
c . set (Calendar . YEAR,  yearNum) ; 

Date  date  = c . get  Time  ()  ; 

String  dayOfWeek  = (new  S imp leDate Format ("EEEE 
outputLabel , setText  (dayOfWeek)  ; 


i a y£y*\y\&&' 


r) ) . format  (date)  ; 


} 


) 
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the  end...  sort  of 


Wouldn’t  it  be 
dreamy  if  this  were  the  end 
of  the  book?  If  there  were  no 
more  bullet  points  or  puzzles 
or  code  listings  or  anything  else? 
But  that's  probably  just  a 
fantasy... 


Congratulations! 

You  made  it  to  the  end. 


Of  course,  there’s  still  the  two  appendices. 
And  the  Index. 

And  then  there’s  the  web  site... 

There’s  no  escape,  really. 
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Cyber  Beat&ox 


«o  g a «□□□«□ □ aso do  j Sfart  ) 

t stop  y 

f Tempo  Up  ^ 
f Tempo  Down  ) 
( sendrt  \ 


: Bass  Drum 

Closed  Hi-Hat  QOSOOaSSQQSOQQSS 
i OpeisHt-Har  Q OO  O 000 OOOOO doo O 
■ Acoustic  Snare  O □ Q O Q 0 Q Q O O O O Q 0.0  O 
Crash  Cymbal  GOOOQOOOOOOOOOOO 

Hahd  Clap  □□□□□□□□□□□□□OOD 

: High  Tom  Q QO QQ Q □□□  QOQO □ DO 

Hi  Bongo 
: Maracas 
Whistle 

Low  Conga  QQOOOOSOOSSOSOOO 
Cowbell  G □ G O O □ OO  □ O DG  Q GOG 

; vibrastap  G O GO O O GQ  GOOD G 0 G O 

Low- mid  Tom  0000000000000000 

: High  Agogo  Q O 000000000 300 oo 

Open  Hi  CongaQQ QSS SO O DdODWS O 
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i dancabeat 


I Andy:  groove  *2 
Chris:  groova2  revised 1 
Nigel:  dance  beat 


Finally,  tke  complete  version  ol  tke  BeatBox! 


v**-  *■«**»¥  ^ *71!* 

with  1**  L Wit 

" fers“/- 

^ pty  n 


It  connects  to  a simple  MusicServer  so  tkai  you  can 
send  and  receive  keat  patterns  witk  otker  clients. 
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Final  BeatBox  client  program 

Most  of  this  code  is  the  same  as  the  code  from  the  CodeKitchens  in  the  previous 
chapters,  so  we  don't  annotate  the  whole  thing  again.  The  new  parts  include: 

GUI  - two  new  components  are  added  for  the  text  area  that  displays  incoming 
messages  (actually  a scrolling  list)  and  the  text  field. 

NETWORKING  - just  like  the  SimpleChatClient  in  this  chapter,  the  BeatBox  now 
connects  to  the  server  and  gets  an  input  and  output  stream. 

THREADS  - again,  just  like  the  SimpleChatClient,  we  start  a ‘reader’  class  that 
keeps  looking  for  incoming  messages  from  the  server.  But  instead  of  just  text,  the 
messages  coming  in  include  TWO  objects:  the  String  message  and  the  serialized 
ArrayList  (the  thing  that  holds  the  state  of  all  the  checkboxes.) 


import  java.awt.*; 
import  javax . swing . * ; 
import  java . io . * ; 
import  javax.  sound. midi  .*  ; 
import  java.util.*; 
import  j ava . awt . event . * ; 
import  java.net.*; 
import  j avax . swing . event . * ; 

public  class  BeatBoxFinal  { 

JFrame  theFrame; 

JPanel  mainPanel; 

JList  incomingList; 

JTextField  userMessage; 

ArrayList<JCheckBox>  checkboxList; 
int  nextNum; 

Vector<String>  listVector  = new  Vector<String>() ; 

String  userName; 

ObjectOutputStream  out; 

ObjectlnputStream  in; 

HashMap<String , boolean[]>  other SeqsMap  = new  HashMap<String,  boolean  []>(); 

Sequencer  sequencer; 

Sequence  sequence; 

Sequence  mySequence  = null; 

Track  track; 


String []  instrumentNames  = {"Bass  Drum",  "Closed  Hi-Hat",  "Open  Hi-Hat" , "Acoustic 
Snare",  "Crash  Cymbal",  "Hand  Clap",  "High  Tom",  "Hi  Bongo",  "Maracas",  "Whistle", 
"Low  Conga",  "Cowbell",  "Vibraslap",  "Low-mid  Tom",  "High  Agogo",  "Open  Hi  Conga"); 

int[]  instruments  = {35,42,46,38,49,39,50,60,70,72,64,56,58,47,67,63}; 
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public  static  void  main  (String []  args)  { 

new  BeatBoxFinal (). startup (args [0] ) ; //  args[0]  is  your  user  ID/ screen  name 

* ^ . Add  a $<*  you'r  s4ree* 

public  void  startup  (String  name)  { c \ % \ava  thcFtasH 

userName  = name;  V**«T*'  r 

//  open  connection  to  the  server 
try  { 

Socket  sock  = new  Socket ("127. 0.0.1",  4242);  Nate*  > wf 

out  « new  ObjectOutputStream(sock.getOutputStream() ) ; * . ?.  ^ makc  fond 

in  = new  Ob jectlnputStream (sock . getlnputStream ( ) ) ; + iheVcader  ‘tkv^ad- 

Thread  remote  = new  Thread  (new  RemoteReader  () ) ; 

remote. start () ; 

} catch (Exception  ex)  { 

System. ou t.prin tin ("couldn' t connect  - you'll  have  to  play  alone."); 

} 

setUpMidi  ()  ; 
buildGUI  ()  ; 

} //  close  startup 

public  void  buildGUI  ()  { t0&t)  new  kere 

theFrame  = new  JFrame ("Cyber  BeatBox") ; 

BorderLayout  layout  = new  BorderLayout ( ) ; 

JPanel  background  = new  JPanel (layout) ; 

background. setBorder (BorderFactory . createEmptyBorder (10 ,10,10,10)); 

checkboxList  = new  ArrayList<JCheckBox>() ; 

Box  buttonBox  = new  Box (BoxLayout .Y_AXIS) ; 

JButton  start  = new  JButton ("Start") ; 

start . addActionListener (new  MyStartListener () ) ; 

buttonBox. add (start) ; 

JButton  stop  = new  JButton ("Stop") ; 

stop . addActionListener (new  MyStopListener ( ) ) ; 

buttonBox.  add  (stop)  ; 

JButton  upTempo  = new  JButton ("Tempo  Up") ; 
upTempo . addActionListener (new  MyUpTempoLi s tener ( ) ) ; 
buttonBox. add (upTempo) ; 

JButton  downTerapo  = new  JButton  ("Tempo  Down")  ; 
downTenpo . addActionListener (new  MyDownTempoLis tener ()); 
buttonBox. add (downTempo)  ; 

JButton  sendlt  = new  JButton ("sendlt") ; 
sendlt. addActionListener (new  My SendLis tener () ) ; 
buttonBox . add (sendlt) ; 

userMessage  = new  JTextField() ; 
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buttonBox.  add(userMessage)  ; 


IncomingLiat  = new  JLlatO  ; 

IncomingList  .addListSelectionListener  (new  MyListSelectionListener (} ) ; 
in  coming  Li  st , setSelectionKoda  (LietSsIectionModel . SIHGM^SELECTIOH)  ; 
JScrollPane  thaList  « new  JScrolIPaim  (incomingList)  ; 
buttonBox . add  (theliis  t)  ; 

incomngLiet.  ■atListBatafXistVfcetor)  ; //  no  d ata  to  start  with 


Box  nameBox  = new  Box (BoxLayout . Y_AXIS)  ; 
for  (int  i * 0;  i < 16;  i++)  { 

nainaBox.add(new  Label  (inatrumantNames  [i] ))  ; 

} 

background . add  (BorderLayout . EAST , buttonBox)  ; 
background. add (BorderLayout. WEST , nameBox)  ; 

theFrame . getContentPane ( ) . add (background) ; 

GridLayout  grid  = now  GridLayout(16,16); 

grid. aatVgap (1) ; 

grid,satHgap(2) ; 

mainPanol  = naw  JPanel  (grid)  ; 

background . add ( Bo r da r Lay out . CENTER , mainPanel) ; 


Lirb  is  3 LvrrY«»er>i  ^ve*  i 

beW  W 

Juado*  3 

hcrt  you  just  L-00X.  at  tb 

«esidys>  i*  “tb**  a?f  y*  ^ , 

;Bl£CT  3 Y'V 

b load  a«d  play  tb  atta^d 


for  (int  i = 0;  i < 256;  i-H*)  { 

JCheckBox  c = new  JChackBox () ; w 

c.  setSelac tad  (false)  ; Irv9  M °h  u hew 

checkboxList.add(c)  ; 
mainPanol . add (c) ; 

) //  end  loop 


theFrama - aetBounds (50 ,50,300, 300) ; 

theFrama  .pack  ( ) ; 

theFr&me . setVisibl©  (true)  ; 

) //  close  buildGUI 


public  void  satUpMidi()  { 
try  { 

sequencer  = HidiSystam. getSequ oncer  () ; 
a aqua near . open ( ) ; 

sequence  ™ new  Sequence  (Sequence  .PPQ,  4)  ; ^Yt  Z 

track  * sequence. area teTrack()  ; 6ct  ^ 

sequencer.  setTampoInBPM(120)  ; rt^t 

) catch (Exception  a)  (a .printStackTraco () ; ) 


) //  close  setUpMLdi 
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public  void  buildTrackAndStart ()  { 

ArrayList<Integer>  trackList  = null;  //  this  will  hold  the  instruments  for  each 


sequence . deleteTrack (track) ; 
track  = sequence. crea teTrack () ; 

for  (int  i = 0;  i < 16;  i++)  { 

trackList  = new  ArrayList<Integer>() 


1 1 

V f M ft  K »1tuV 

^‘X  a5a"" 

oarf«^'*eri‘  ^ 5 


for  (int  j = 0;  j < 16;  j++)  { 

JCheckBox  jc  = (JCheckBox)  checkboxList .get ( j + (16*i) ) ; 
if  ( jc.isSelectedO  ) { 

int  key  = instruments [i] ; 
trackList . add (new  Integer (key) ) ; 

} else  ( 

trackList. add (null) ; //  because  this  slot  should  be  empty  in  the  track 

} 


} //  close  inner  loop 

makeTracks (trackList) ; 

} //  close  outer  loop 

track. add(makeEvent (192, 9,1,0,15) ) ; //  - so  we  always  go  to  full  16  beats 
try  { 

sequencer . setSequence (sequence) ; 

sequencer . setLoopCount (sequencer . L(X>P_CONTINUOUSLY) ; 

sequencer . start () ; 

sequencer . setTempoInBFM  (120) ; 

} catch (Exception  e)  {e .prints tackTrace (); } 

} //  close  method 


public  class  MyStartListener  implements  ActionListener  { 
public  void  actionPerf ormed (ActionEvent  a)  { 
buildTrackAndStart () ; 

) //  close  actionPerformed 
} //  close  inner  class 

public  class  MyStopListener  implements  ActionListener  { 
public  void  actionPerformed (ActionEvent  a)  { 
sequencer . stop ( ) ; 

) //  close  actionPerformed 
} //  close  inner  class 


U,e  sa*e  *s  Y8 


public  class  fttyUpTexrpoListener  implements  ActionListener  { 
public  void  actionPerformed (ActionEvent  a)  { 

float  tempoFactor  = sequencer. getTempoFactor ()  ; 
sequencer . setTempoFactor  ( (float)  ( tempoFactor  * 1.03)); 

} //  close  actionPerformed 
) //  close  inner  class 
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public  class  MyDownTempoListener  implements  ActionListener  { 
public  void  actionPerformed  (ActionEvent  a)  { 
float  terapoFactor  = sequencer . get TempoFac tor  ()  ; 
sequencer. setTerapoFactor(  (float)  (tempoFactor  * .97)); 

> 

} 


public  class  MySendListener  implements  ActionListener  { 
public  void  actionPerformed  (ActionEvent  a)  { 

//  make  an  arraylist  of  just  the  STATE  of  the  checkboxes 
boolean []  checkboxState  = new  boolean [256] ; 
for  (int  i = 0;  i < 256;  i++)  { 

JCheckBox  check  = (JCheckBox)  checkboxList.get (i) 
if  (check . isSelected ( ) ) { 
checkboxState [i]  = true; 

} 

} //  close  loop 

String  messageToSend  = null; 
try  { 

out.writeObject (userName  + nextNum++ 
out.writeObject (checkboxState) ; 

} catch (Exception  ex)  ( 

System. out. println ("Sorry  dude.  Could  not  send  it  to  the 

} 

userMessage.setText ("") ; 

} //  close  actionPerformed 
} //  close  inner  class 


tvio  OV 


+ userMessage . getText ( ) ) 


server . " ) 


} 


public  class  MyListSelectionListener  implements  ListSelectionListener  { 
public  void  valueChanged (ListSelectionEvent  le)  { 
if  ( ! le . getValuelsAd justing ( ) ) { 

String  selected  = (String)  incomingList.getSelectedValue () ; 
if  (selected  !=  null)  { 

//  now  go  to  the  map,  and  change  the  sequence 

boolean [ ] selectedState  = (boolean [ ] ) otherSeqsMap . get (selected) ; 
change Sequence (selectedState) ; 
sequencer . stop ( ) ; 
buildTrackAndStart () ; 


} //  close  valueChanged 
//  close  inner  class 
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public  class  Remote Reader  implements  Runnable  { 
boolean []  checkboxState  = null; 

String  nameToShow  = null; 

Object  obj  = null; 
public  void  run()  { 
try  { 

while { (obj=in.readObject () ) !=  null)  { 

System. out. println ("got  an  object  from  serv< 
System.out.println(obj . getClass () ) ; 

String  nameToShow  = (String)  6b j ; 
checkboxState  = (boolean[])  in. readObject () 
other SeqsMap . put (nameToShow , checkboxState) 
listVector . add  (nameToShow)  ; 
incomingList . setListData (listVector) ; 

} //  close  while 

} catch (Exception  ex)  { ex . printStackTrace ( ) ; } 

) //  close  run 
//  close  inner  class 
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public  class 
public  void 

if  (mySequence  !=  null)  { 
sequence  = mySequence; 

} 


the 

5 s°b)r£e 


//  restore  to  my  original 


} //  close  actionPerformed 
) //  close  inner  class 

public  void  changeSequence (boolean [ ] 
for  (int  i = 0;  i < 256;  i++)  { 

JCheckBox  check  = (JCheckBox)  checkboxList .get (i) ; 
if  (checkboxState [i] ) { 

check. setSelected (true) ; 

} else  { 

check. setSelected (false) ; 


ch.ckb.«st.<**»¥  tk<  Fiiitn  ft  ft*  J*  S«y 


} 

) //  close  loop 
} //  close  changeSequence 
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public  void  makeTracks  (ArrayList  list)  { 

Iterator  it  = list . iterator () ; 
for  (int  i = 0;  i < 16;  i++)  { 

Integer  num  = (Integer)  it. next () ; 
if  (num  ■ = null)  { 

int  numKey  = num.  intValue  ()  ; 

track . add (makeEvent (144 , 9, numKey,  100,  i) ) ; 

track . add (makeEvent (128, 9, numKey, 100,  i + 1)); 

} 

} //  close  loop 
} //  close  makeTracks ( ) 
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public  MidiEveirt  makeEvent (int  comd,  int  chan,  int  one,  int  two,  int  tick)  { 
MidiEvent  event  = null; 
try  { 

ShortMessage  a = new  ShortMessage () ; 
a.setMessage(comd,  chan,  one,  two) ; 
event  = new  MidiEvent  (a,  tick)  ; 

} catch (Exception  e)  { } 
return  event; 

) //  close  makeEvent 


) //  close  class 
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What  are  some  of  the  ways  you  can  improve  this  program? 

Here  are  a few  ideas  to  get  you  started: 

1)  Once  you  select  a pattern,  whatever  current  pattern  was  playing  is  blown 
away.  If  that  was  a new  pattern  you  were  working  on  (or  a modification  of 
another  one),  you're  out  of  luck.  You  might  want  to  pop  up  a dialog  box  that 
asks  the  user  if  he'd  like  to  save  the  current  pattern. 


2)  If  you  fail  to  type  in  a command-line  argument,  you  just  get  an  exception 
when  you  run  it!  Put  something  in  the  main  method  that  checks  to  see  if 
you've  passed  in  a command-line  argument.  If  the  user  doesn't  supply  one, 
either  pick  a default  or  print  out  a message  that  says  they  need  to  run  it 
again,  but  this  time  with  an  argument  for  their  screen  name. 


3)  It  might  be  nice  to  have  a feature  where  you  can  click  a button  and  it 
will  generate  a random  pattern  for  you.  You  might  hit  on  one  you  really  like. 
Better  yet,  have  another  feature  that  lets  you  load  in  existing  'foundation' 
patterns,  like  one  for  jazz,  rock,  reggae,  etc.  that  the  user  can  add  to. 

You  can  find  existing  patterns  on  the  Head  First  Java  web  start. 
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Final  BeatBox  server  program 

Most  of  this  code  is  identical  to  the  SimpleChatServer  we  made  in  the 
Networking  and  Threads  chapter.  The  only  difference,  in  fact,  is  that  this  server 
receives,  and  then  re-sends,  two  serialized  objects  instead  of  a plain  String 
(although  one  of  the  serialized  objects  happens  to  be  a String). 


import  java.io.*; 
import  java.net.*; 
import  java. util.*; 

public  class  MusicServer  { 

ArrayList<Ob jectOutputStream>  clientOutputStreams ; 

public  static  void  main  (String []  args)  { 
new  MusicServer () *go() ; 

} 

public  class  ClientHandler  implements  Runnable  { 

ObjectlnputStream  in; 

Socket  clientSocket; 

public  ClientHandler (Socket  socket)  { 
try  { 

clientSocket  = socket; 

in  = new  ObjectInputStream(clientSocket.getInputStream() ) ; 

} catch (Exception  ex)  { ex . printStackTrace ( ) ; } 

} //  close  constructor 


public  void  run<)  { 

Object  o2  = null; 

Object  ol  = null; 
try  { 

while  ( (ol  = in.readObject() ) 1=  null)  { 
o2  = in.readObject(); 

System. out.pr in tin ("read  two  objects") ; 
tellEveryone(ol,  o2) ; 

} //  close  while 

} catch (Exception  ex)  (ex. printStackTrace () ; } 

} //  close  run 
} //  close  inner  class 
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public  void  go()  { 

clientOutputStreams  = new  ArrayList<ObjectOutputStream>() ; 
try  { 

ServerSocket  serverSock  = new  ServerSocket (4242) ; 
while (true)  ( 

Socket  clientSocket  = server Sock . accept ( ) ; 

ObjectOutputStream  out  = new  ObjectOutputStream(clientSocket.getOutputStream() ) 
clientOutputStreams. add (out) ; 

Thread  t = new  Thread (new  ClientHandler (clientSocket) ) ; 
t. start () ; 

System. out. println ("got  a connection") ; 

} 

} catch (Exception  ex)  { 
ex .prints tackTrace () ; 

} 

} //  close  go 

public  void  tellEveryone (Object  one,  Object  two)  { 

Iterator  it  = clientOutputStreams . iterator () ; 
while (it.hasNext () ) { 
try  { 

ObjectOutputStream  out  = (ObjectOutputStream)  it.next()  ; 
out.writeObject (one) ; 
out . writeOb ject ( two) ; 

} catch (Exception  ex)  { ex . printStackTrace ( ) ; } 

} 

} //  close  tellEveryone 
} //  close  class 
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The  Top  Ten  Topics  that  almost  made  it  into  the  Real  Book... 


We  covered  a lot  of  ground,  and  you're  almost  finished  with  this  book.  We'll  miss  you,  but  before 
we  let  you  go,  we  wouldn't  feel  right  about  sending  you  out  Into  JavaLand  without  a little  more 
preparation.  We  can't  possibly  fit  everything  you'll  need  to  know  Into  this  relatively  small  appendix. 
Actually,  we  did  originally  Include  everything  you  need  to  know  about  Java  (not  already  covered  by 
the  other  chapters),  by  reducing  the  type  point  size  to  .00003.  It  all  fit,  but  nobody  could  read  It.  So, 
we  threw  most  of  it  away,  but  kept  the  best  bits  for  this  Top  Ten  appendix. 

This  really  h the  end  of  the  book.  Except  for  the  index  (a  must-read!). 
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#10  Bit  Manipulation 

Why  do  you  care? 

We’ve  talked  about  the  fact  that  there  are  8 bits  in  a byte, 

16  bits  in  a short,  and  so  on.  You  might  have  occasion  to 
turn  individual  bits  on  or  off.  For  instance  you  might  find 
yourself  writing  code  for  your  new  Java  enabled  toaster, 
and  realize  that  due  to  severe  memory  limitations,  certain 
toaster  settings  are  controlled  at  the  bit  level.  For  easier 
reading,  we’re  showing  only  the  last  8 bits  in  the  comments 
rather  than  the  full  32  for  an  int). 

Bitwise  NOT  Operator:  * 

This  operator  ‘flips  all  the  bits’  of  a primitive. 

int  x = 10;  //  bits  are  00001010 

x = ~x;  //  bits  are  now  11110101 

The  next  three  operators  compare  two  primitives  on  a bit 
by  bit  basis,  and  return  a result  based  on  comparing  these 
bits.  We’ll  use  the  following  example  for  the  next  three 
operators: 

int  x * 10;  //  bits  are  00001010 

int  y = 6;  //  bits  are  00000110 

Bitwise  AND  Operator:  & 

This  operator  returns  a value  whose  bits  are  turned  on  only 
if  both  original  bits  are  turned  on: 

int  a = x & y;  //  bits  are  00000010 

Bitwise  OR  Operator:  | 

This  operator  returns  a value  whose  bits  are  turned  on  only 
if  either  of  the  original  bits  are  turned  on: 

int  a = x I y;  //  bits  are  00001110 

Bitwise  XOR  (exclusive  OR)  Operator:  A 

This  operator  returns  a value  whose  bits  are  turned  on  only 
if  exactly  one  of  the  original  bits  are  turned  on: 

int  a = x A y;  / / bits  are  00001100 


The  Shift  Operators 

These  operators  take  a single  integer  primitive  and  shift  (or 
slide)  all  of  its  bits  in  one  direction  or  another.  If  you  want 
to  dust  off  your  binary  math  skills,  you  might  realize  that 
shifting  bits  left  effectively  multiplies  a number  by  a power  of 
two,  and  shifting  bits  right  effectively  divides  a number  by  a 
power  of  two. 

We’ll  use  the  following  example  for  the  next  three  operators: 

int  x = -11;  //  bits  are  11110101 

Ok,  ok,  we’ve  been  putting  it  off,  here  is  the  world’s 
shortest  explanation  of  storing  negative  numbers,  and 
two's  complement . Remember,  the  leftmost  bit  of  an  integer 
number  is  called  the  sign  bit  A negative  integer  number  in 
Java  always  has  its  sign  bit  turned  on  (i.e.  set  to  1) . A positive 
integer  number  always  has  its  sign  bit  turned  off(O).  Java 
uses  the  two's  complement  formula  to  store  negative  numbers. 
To  change  a number’s  sign  using  two’s  complement,  flip  all 
the  bits,  then  add  1 (with  a byte,  for  example,  that  would 
mean  adding  00000001  to  the  flipped  value). 

Right  Shift  Operator:  » 

This  operator  shifts  all  of  a number’s  bits  right  by  a certain 
number,  and  fills  all  of  the  bits  on  the  left  side  with  whatever 
the  original  leftmost  bit  was.  The  sign  bit  does  not  change: 

in t y = x » 2;  //  bits  are  11111101 

Unsigned  Right  Shift  Operator:  »> 

Just  like  the  right  shift  operator  BUT  it  ALWAYS  fills  the 
leftmost  bits  with  zeros.  The  sign  bit  might  change: 

int  y - x »>  2;  //  bits  are  00111101 

Left  Shift  Operator:  « 

Just  like  the  unsigned  right  shift  operator,  but  in  the  other 
direction;  the  rightmost  bits  are  filled  with  zeros.  The  sign  bit 
might  change. 

int  y = x « 2;  //  bits  are  11010100 
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#9  Immutability 

Why  do  you  care  that  Strings  are  Immutable? 

When  y our  Java  programs  start  to  get  big,  you'll 
inevitably  end  up  with  lots  and  lots  of  String  objects. 
For  security  purposes,  and  For  the  sake  of  conserving 
memory  (remember  your  Java  programs  can  run  on 
teeny  Java-enabled  cell  phones),  Strings  in  Java  are 
immutable.  What  this  means  is  that  when  you  say: 

String  9 = “0"; 

for  (int  x = 1;  x < 10;  x++j  { 

a = 3 + X; 

) 

What's  actually  happening  is  that  you're  creating  ten 
String  objects  (with  values 41 0”,  “01”,  “012”,  through 
“0123456789”).  In  the  end  sis  referring  to  the  String 
with  the  value  “0123456789”,  but  at  this  point  there 
are  ten  Strings  in  existence! 

Whenever  you  make  a new  String,  the  JVM  puts  it 
into  a special  part  of  memory  called  the  'String  Pool1 
(sounds  refreshing  doesn't  it?).  If  there  is  already 
a String  in  the  String  Pool  with  the  same  value,  the 
JVM  doesn’t  create  a duplicate,  it  simply  refers  your 
reference  variable  to  the  existing  entry.  The  JVM  can 
get  away  with  this  because  Strings  are  immutable;  one 
reference  variable  can't  change  a String's  value  out 
from  under  another  reference  variable  referring  to 
the  same  Suing. 

The  other  issue  with  the  String  pool  is  that  the 
Garbage  Collector  doesn't  go  there . So  in  our  example, 
unless  by  coincidence  you  later  happen  to  make  a 
String  called  “01234”,  for  instance,  the  first  nine 
Strings  created  in  our  for  loop  will  just  sit  around 
wasting  memory. 

How  does  this  save  memory? 

Well,  if  you're  not  careful,  it  doesn't!  But  if  you  un- 
derstand how  String  immutability  works,  than  you 
can  sometimes  take  advantage  of  it  to  save  memory. 

If  you  have  to  do  a lot  of  String  manipulations  (like 
concatenations,  etc.),  however,  there  is  another  class 
StringBuilder,  better  suited  for  that  purpose,  We'll 
talk  more  about  StringBuilder  in  a few  pages, 


Why  do  you  care  that  Wrappers  are 
Immutable? 

In  the  Math  chapter  we  talked  about  the  two  main 
uses  of  the  wrapper  classes: 

• Wrapping  a primitive  so  it  can  pretend  to  be  an 
object. 

• Using  the  static  utility  methods  (for  example. 
Integer.  parselntO). 

It's  important  to  remember  that  when  you  create  a 
wrapper  object  like: 

Integer  iWrap  = new  Integer  (42); 

That's  it  for  that  wrapper  object.  Its  value  will  always 
be  42.  There  is  no  setter  method  for  a wrapper  object 
You  can,  of  course,  refer  iWrap  to  a different  wrapper 
object,  but  then  you'll  have  two  objects.  Once  you 
create  a wrapper  object,  there’s  no  way  to  change 
the  value  of  that  object! 
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#8  Assertions 

We  haven't  talked  much  about  how  to  debug  your  Java 
program  while  you're  developing  it  We  believe  that 
you  should  learn  Java  at  the  command  line,  as  we‘ve 
been  doing  throughout  the  book.  Once  you're  a Java 
pro,  if  you  decide  to  use  an  DDE*,  you  might  have 
other  debugging  tools  to  use.  In  the  old  days,  when 
a Java  programmer  wanted  to  debug  her  code,  she'd 
stick  a bunch  of  System.out.println( ) statements 
throughout  the  program,  printing  current  variable 
values,  and  "I  got  here”  messages,  to  see  if  the  flow 
control  was  working  properly.  (The  ready-bake  code 
in  chapter  6 left  some  debugging  'print'  statements 
in  the  code.)  Then,  once  the  program  was  working 
correctly,  she'd  go  through  and  take  all  those  System. 
out.prindn{  ) statements  back  out  again.  It  was 
tedious  and  error  prone.  But  as  of  Java  1.4  (and  5.0), 
debugging  got  a whole  lot  easier.  The  answer? 

Assertions 

Assertions  are  like  System.outprintln( ) statements 
on  steroids.  Add  them  to  your  code  as  you  would 
add  println  statements.  The  Java  5.0  compiler 
assumes  you'll  be  compiling  source  files  that  are  5.0 
compatible,  so  as  of  Java  5,0,  compiling  with  assertions 
is  enabled  by  default. 

At  runtime,  if  you  do  nothing,  the  assert  statements 
you  added  to  your  code  will  be  ignored  by  the  JVM, 
and  won't  slow  down  your  program.  But  if  you  tell  the 
JVM  to  enable  your  assertions,  they  will  help  you  do 
your  debugging,  without  changing  a line  of  code! 

Some  folks  have  complained  about  having  to  leave 
assert  statements  in  their  production  code,  but 
leaving  them  in  can  be  really  valuable  when  your 
code  is  already  deployed  in  the  field.  If  your  client 
is  having  trouble,  you  can  instruct  the  client  to  run 
the  program  with  assertions  enabled,  and  have  the 
client  send  you  the  output.  If  the  assertions  were 
stripped  out  of  your  deployed  code,  you'd  never 
have  that  option.  And  there  is  almost  no  downside; 
when  assertions  are  not  enabled,  they  are  completely 
ignored  by  the  JVM,  so  there's  no  performance  hit  to 
worry  about. 


How  to  make  Assertions  work 

Add  assertion  statements  to  your  code  wherever  you 
believe  that  something  must  be  true.  For  instance: 

assert  (height  > 0) ; 

//  if  true,  program  continues  normally 
/ / if  false,  throw  an  AssertionError 

You  can  add  a little  more  information  to  the  stack 
trace  by  saying: 

assert  (height  > 0)  : “height  = " + 

height  + " weight  = “ + weight; 

The  expression  after  the  colon  can  be  any  legal 
Java  expression  that  resolves  to  a non-null  value , But 
whatever  you  do,  don't  create  assertions  that  change  an 
object's  state ! If  you  do,  enabling  assertions  at  runtime 
might  change  how  your  program  performs. 

Compiling  and  running  with 
Assertions 

To  compile  with  assertions: 

javac  TestDriveGame ► java 

(Notice  that  no  command  line  options  were 
necessary.) 

To  run  with  assertions: 
java  -ea  TestDriveGame 


* IDE  stands  for  Integrated  Development  Environment 
and  includes  tools  such  as  Eclipse,  Borland's  JBuilder,  or 
the  open  source  NetBeans  (netbeans.org). 
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#7  Block  Scope 

In  chapter  9,  we  talked  about  how  local  variables 
live  only  as  long  as  the  method  in  which  they’re 
declared  stays  on  the  stack.  But  some  variables  can 
have  even  shorter  lifespans.  Inside  of  methods,  we 
often  create  blocks  of  code.  We’ve  been  doing  this 
all  along,  but  we  haven’t  explicitiy  talked  in  terms  of 
blocks . Typically,  blocks  of  code  occur  within  methods, 
and  are  bounded  by  curly  braces  { }.  Some  common 
examples  of  code  blocks  that  you’ll  recognize  include 
loops  (for , while)  and  conditional  expressions  (like  if 
statements). 

lv.qA  Wotk 

Let’s  look  at  an  example:  ^ Lke 

void  doStuff  ()  {<r  . l ll#  mrtW 

fordnt  y = 0;  y < 5;  y++)  \ < ^ 
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end  o(  ike  -for  loop  block 
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In  the  previous  example,  y was  a block  variable, 
declared  inside  a block,  and  y went  out  of  scope  as 
soon  as  the  for  loop  ended.  Your  Java  programs  will 
be  more  debuggable  and  expandable  if  you  use  local 
variables  instead  of  instance  variables,  and  block 
variables  instead  of  local  variables,  whenever  possible. 
The  compiler  will  make  sure  that  you  don’t  try  to  use 
a variable  that’s  gone  out  of  scope,  so  you  don’t  have 
to  worry  about  runtime  meltdowns. 
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#6  Linked  Invocations 

While  you  did  see  a little  of  this  in  this  book,  we  tried  to  keep  our  syntax  as  clean  and 
readable  as  possible*  There  are,  however,  many  legal  shortcuts  in  Java,  that  you'll  no  doubt 
be  exposed  to,  especially  if  you  have  to  read  a lot  code  you  didn't  write.  One  of  the  more 
common  constructs  you  will  encounter  is  known  as  linked  invocations.  For  example: 

StringBuffer  sb  = new  StringBuff er ( "spring" ) ; 

sb  = sb. delete (3, 6) . insert (2, "umme") . deleteCharAt (1) ; 

System. out .println ("sb  = " + sb) ; 

//  result  is  sb  = summer 

What  in  the  world  is  happening  in  the  second  line  of  code?  Admittedly,  this  is  a contrived 
example,  but  you  need  to  learn  how  to  decipher  these. 

1 - Work  from  left  to  right. 

2 - Find  the  result  of  the  leftmost  method  call,  in  this  case  sb . delete  (3,6).  If  you 
look  up  StringBuffer  in  the  API  docs,  you'll  see  that  the  delete  ( ) method  returns  a 
StringBuffer  object.  The  result  of  running  the  delete  ( ) method  is  a StringBuffer  object 
with  the  value  “spr”. 

3 - The  next  leftmost  method  (insert  ( ) )is  called  on  the  newly  created  StringBuffer 
object  “spr”.  The  result  of  that  method  call  (the  insert  ( ) method),  is  also  a StringBuffer 
object  (although  it  doesn't  have  to  be  the  same  type  as  the  previous  method  return),  and  so 
it  goes,  the  returned  object  is  used  to  call  the  next  method  to  the  right.  In  theory,  you  can 
link  as  many  methods  as  you  want  in  a single  statement  (although  it's  rare  to  see  more  than 
three  linked  methods  in  a single  statement).  Without  linking,  the  second  line  of  code  from 
above  would  be  more  readable,  and  look  something  like  this: 


sb  = sb . delete  (3, 6) ; 
sb  = sb. insert (2, "umme") ; 
sb  = sb. deleteCharAt (1) ; 

But  here's  a more  common,  and  useful  example,  that  you  saw  us  using,  but  we  thought 
we'd  point  it  out  again  here.  This  is  for  when  your  main()  method  needs  to  invoke  an 
instance  method  of  the  main  class,  but  you  don’t  need  to  keep  a reference  to  the  instance  of 
the  class.  In  other  words,  the  main()  needs  to  create  the  instance  only  so  that  main()  can 
invoke  one  of  the  instance’s  methods . 


class  Foo  { 

public  static  void  main (String 
new  Foo  ( ) . go  ( ) ; 

} 

void  go()  { -bV\e 

//  here's  what  we  REALLY  want... 

} 


— ^ LJ  args)  [ 
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#5  Anonymous  and  Static  Nested  Classes 


Nested  classes  come  In  many  flavors 

In  the  GUI  event-handling  section  of  the  book,  we  started  using  inner  (nested)  classes  as  a 
solution  for  implementing  listener  interfaces.  That's  the  most  common,  practical,  and  read- 
able form  of  an  inner  class — where  the  class  is  simply  nested  within  the  curly  braces  of  another 
enclosing  class.  And  remember,  it  means  you  need  an  instance  of  the  outer  class  in  order  to  get 
an  instance  of  the  inner  class,  because  the  inner  class  is  a member  of  the  outer/enclosing  class. 

But  there  are  other  kinds  of  inner  classes  including  static  and  anonymous . WeTe  not  going 
into  the  details  here,  but  we  don't  want  you  to  be  thrown  by  strange  syntax  when  you  see  it  in 
someone's  code.  Because  out  of  virtually  anything  you  can  do  with  the  Java  language,  perhaps 
nothing  produces  more  bizarre-looking  code  than  anonymous  inner  classes.  But  we'll  start  with 
something  simpler — static  nested  classes. 

Static  nested  classes 

You  already  know  what  static  means — something  tied  to  the  class,  not  a particular  instance.  A 
static  nested  class  looks  just  like  the  non-static  classes  we  used  For  event  listeners,  except  they're 
marked  with  the  keyword  static. 


public  class  FooOuter  { 


flats 


static  i class  Barlnner  { 
void  saylt()  { 

System. out, println ("method  of  a static  inner  class'"); 

) 


) 

Static  nested  classes  are  more  like  regular  non-nested  classes  in  that  they  don't  enjoy  a special  relation- 
ship with  an  enclosing  outer  object.  But  because  static  nested  classes  are  still  considered  a member  of 
the  enclosing/ outer  class,  they  still  get  access  to  any  private  members  of  the  outer  class...  but  only  the 
ones  that  are  also  static.  Since  the  static  nested  class  isn't  connected  to  an  instance  of  the  outer  class,  it 
doesn't  have  any  special  way  to  access  the  non^static  (instance)  variables  and  methods. 
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#5  Anonymous  and  Static  Nested  Classes,  continued 


The  difference  between  nested  and  Inner 

Anyjava  class  that's  defined  within  the  scope  of  another  class  is  known  as  a nested  class.  It 
doesn't  matter  if  it's  anonymous,  static,  normal,  whatever.  If  it's  inside  another  class,  it's 
technically  considered  a nested  class.  But  nan-static  nested  classes  are  often  referred  to  as  inner 
classes,  which  is  what  we  called  them  earlier  in  the  book.  The  bottom  line:  all  inner  classes  are 
nested  classes,  but  not  all  nested  classes  are  inner  classes. 

Anonymous  inner  classes 

Imagine  you're  writing  some  GUI  code,  and  suddenly  realize  that  you  need  an  instance 
of  a class  that  implements  Actionlistener.  But  you  realize  you  don’t  have  an  instance  of  an 
ActionListener.  Then  you  realize  that  you  also  never  wrote  a class  for  that  listener.  You  have  two 
choices  at  that  point: 

1)  Write  an  inner  class  in  your  code,  the  way  we  did  in  our  GUI  code,  and  then  instantiate  it 
and  pass  that  instance  into  the  button's  event  registration  (addActionListener())  method. 

OR 


2)  Create  an  anonymous  inner  class  and  instantiate  it,  right  there,  just-in-time.  Literally  rigfti 
where  you  are  at  the  point  you  need  the  listener  object  That's  right,  you  create  the  class  and  the 
instance  in  tthe  place  where  you'd  normally  be  supplying  just  the  instance.  Think  about  that  for 
a moment — it  means  you  pass  the  entire  class  where  you'd  normally  pass  only  an  instance  into  a 
method  argument! 


import  java . awt. event. *; 
import  javax . swing .* ; 
public  class  TestAnon  { 
public  static  void  main 


(String [ ] args)  ( 


c c 5*4  added  i WtW 


JFrame  frame  = new  JFrameO; 

JButton  button  = new  JButton (“click") ; 
frame. getContentPane () .add (button) ; J 
//  button . addActionListener (quitListene 


TVis 

y button .addActionListener  (new  ActionListaner ()  { 
f public  void  actionPerforrrf^(ActionEvent  ev)  { 
/ System. exit (0) ; 


,ited  wysw 

«>  • t 

. .,,L 

. j >1*  ^ ° j 


>) 


Hcbu  k*  « <V*“  W&tiu  a,d  - y« 


Cnds  do** 


) 
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#4  Access  Levels  and  Access  Modifiers  (Who  Sees  What) 


Java  has  four  access  levels  and  three  access  modifiers . There  are  only  three  modifiers  because 
the  default  (what  you  get  when  you  don’t  use  any  access  modifier)  is  one  of  the  four 
access  levels. 


Access  Levels  (in  order  of  how  restrictive  they  are,  from  least  to  most  restrictive) 


public 


|>ublid  means  any  Code  anywhere  dan  addess  ihe  publid  thing  (by 
‘thing  we  mean  dlass,  variable*  method,  donstsrudtor,  etdT 


protected  — - protected  works  just  like  default  (dode  in  the  same  padkage  has  addess),  EXCEPT  it 

also  allows  subdlasses  outside  the  padkage  to  inherit  the  protedted  thing. 


default 

private 


default  addess  means  that  only  code  within  the  same  padkage  as 
the  dlass  with  the  default  thing  dan  addess  the  default  thing. 

private  means  that  only  Code  within  the  same  dlass  dan  addess  the  private  thing, 
^eep  in  mind  it  means  private  to  the  dlass,  not  private  to  the  objedt  One  Dog 
dan  see  another  Dog  objedt's  private  stuW,  but  a Cat  dan t see  a Dogs  privates. 


Access  modifiers 


public 

protected 

private 


Most  of  the  time  you’ll  use  only  public  and  private  access  levels. 

public 

Use  public  for  classes,  constants  (static  final  variables),  and  methods  that  you’re 
exposing  to  other  code  (for  example  getters  and  setters)  and  most  constructors. 

private 

Use  private  for  virtually  all  instance  variables,  and  for  methods  that  you  don’t  want 
outside  code  to  call  (in  other  words,  methods  used  by  the  public  methods  of  your  class) . 

But  although  you  might  not  use  the  other  two  (protected  and  default),  you  still  need  to 
know  what  they  do  because  you’ll  see  them  in  other  code. 
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#4  Access  Levels  and  Access  Modifiers,  cont. 

default  and  protected 

default 

Both  protected  and  default  access  levels  are  tied  to  packages.  Default  access  is  simple — it 
means  that  only  code  within  the  same  package  can  access  code  with  default  access.  So  a 
default  class,  for  example  (which  means  a class  that  isn't  explicitly  declared  as  public)  can 
be  accessed  by  only  classes  within  the  same  package  as  the  default  class. 

But  what  does  it  really  mean  to  access  a class?  Code  that  does  not  have  access  to  a class  is 
not  allowed  to  even  think  about  the  class.  And  by  think,  we  mean  u^the  class  in  code. 

For  example,  if  you  don't  have  access  to  a class,  because  of  access  restriction,  you  aren't 
allowed  to  instantiate  the  class  or  even  declare  it  as  a type  for  a variable,  argument,  or 
return  value.  You  simply  can't  type  it  into  your  code  at  all!  If  you  do,  the  compiler  will 
complain. 

Think  about  the  implications — a default  class  with  public  methods  means  the  public 
methods  aren't  really  public  at  all.  You  can't  access  a method  if  you  can’t  see  the  class. 

Why  would  anyone  want  to  restrict  access  to  code  within  the  same  package?  Typically, 
packages  are  designed  as  a group  of  classes  that  work  together  as  a related  set.  So  it  might 
make  sense  that  classes  within  the  same  package  need  to  access  one  another's  code,  while 
as  a package,  only  a small  number  of  classes  and  methods  are  exposed  to  the  outside 
world  (i.e.  code  outside  that  package). 


OK,  that’s  default.  It's  simple— if  something  has  default  access  (which,  remember,  means 
no  explicit  access  modifier!),  only  code  within  the  same  package  as  the  default  thing 
(class,  variable,  method,  inner  class)  can  access  that  thing. 

Then  what's  protected  for? 

protected 

Protected  access  is  almost  identical  to  default  access,  with  one  exception;  it  allows  sub- 
classes to  inherit  the  protected  thing,  even  if  those  subclasses  are  outside  the  package  of  the  super- 
class they  extend  That's  it.  That's  ail  protected  buys  you — the  ability  to  let  your  subclasses 
be  outside  your  superclass  package,  yet  still  inherit  pieces  of  the  class,  including  methods 
and  constructors. 

Many  developers  find  very  little  reason  to  use  protected,  but  it  is  used  in  some  designs, 
and  some  day  you  might  find  it  to  be  exactly  what  you  need.  One  of  the  interesting  things 
about  protected  is  that — unlike  the  other  access  levels — protected  access  applies  only  to 
inheritance,  [fa  subclass-outside-the-package  has  a reference  to  an  instance  of  the  superclass 
(the  superclass  that  has,  say,  a protected  method),  the  subclass  can't  access  the  pro- 
tected method  using  that  superclass  reference!  The  only  way  the  subclass  can  access  that 
method  is  by  inheriting  it.  In  other  words,  the  subcla$s-outside-ihe-package  doesn't  have 
access  to  the  protected  method,  it  just  has  the  method,  through  inheritance. 
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#3  String  and  StringBuffer/StringBuilder  Methods 


Two  of  the  most  commonly  used  classes  in  the  Java  API  are  String  and  StringBuffer  (remember  from 
#9  a few  pages  back,  Strings  are  immutable,  so  a StringBuffer/StringBuilder  can  be  a lot  mor  efficient 
if  you’re  manipulating  a String).  As  of  Java  5.0  you  should  use  the  StringBuilder  class  instead  of 
StringBuffer,  unless  your  String  manipulations  need  to  be  thread-safe,  which  is  not  common,  Here’s  a 
brief  overview  of  the  key  methods  in  these  classes: 


Both  String  and  StringBuffer/StringBuilder  classes  have: 


char  charAt(int  index); 
int  lengthQ; 

String  substring  (int  start,  int  end); 
String  toStringO; 


/ / what  char  is  at  a certain  position 
/ / how  long  is  this 
//  get  a part  of  this 
/ / what’s  the  String  value  of  this 


To  concatenate  Strings: 

String  concat(string) ; / / for  the  String  class 

String  append  (String);  //  for  StringBuffer  Sc  StringBuilder 


The  String  class  has: 

String  replace  (char  old,  char  new); 
String  substring(int  begin,  int  end); 
char  []  toCharArrayQ; 

String  toLowerCase(); 

String  toUpperCase(); 

String  trimQ; 

String  valueOf(char  []) 

String  valueOf(int  i) 


/ / replace  all  occurences  of  a char 
/ / get  a portion  of  a String 
/ / convert  to  an  array  of  chars 
/ / convert  all  characters  to  lower  case 
//  convert  all  characters  to  upper  case 
//  remove  whitespace  from  the  ends 
/ / make  a String  out  of  a char  array 

/ / make  a String  out  of  a primitive 
//  other  primitives  are  supported  as  well 


The  StringBuffer  & StringBuilder  classes  have: 

StringBxxxx  delete  (int  start,  int  end) ; / / delete  a portion 

StringBxxxx  insert(int  offset,  any  primitive  or  a char  [] ) ; //  insert  something 

StringBxxxx  replace  (int  start,  int  end.  String  s);  //  replace  this  part  with  this 

StringBxxxx  reverse ();  //  reverse  the  SB  from  front 

void  setCharAt(int  index,  char  ch);  //  replace  a given  character 

Note:  StringBxsm:  refers  to  either  StringBuffer  or  String  Builder,  as  appropriate. 


String 
to  back 


you  are  here  * 669 


when  arrays  aren’t  enough 


#2  Multidimensional  Arrays 

In  most  languages,  if  you  create,  say,  a 4 x 2 two-dimensional  array,  you  would  visualize  a 
rectangle,  4 elements  by  2 elements,  with  a total  of  8 elements.  But  in  Java,  such  an  array 
would  actually  be  5 arrays  linked  together!  In  Java,  a two  dimensional  array  is  simply  an  array 
of  arrays . (A  three  dimensional  array  is  an  array  of  arrays  of  arrays,  but  we’ll  leave  that  for 
you  to  play  with.)  Here’s  how  it  works 

int[)[]  a2d  = new  int  [4)[2J; 

The  JVM  creates  an  array  with  4 elements.  Each  of  these  four  elements  is  actually  a reference 
variable  referring  to  a (newly  created),  int  array  with  2 elements. 


a,4av  mt*  y>  'nside 

JjdCUci] 


vaTx 


aWts 


lnt[][] 


int  array  abject  (mt[][]) 


Working  with  multidimensional  arrays 

-To  access  the  second  element  in  the  third  array:  int  x = a2d[2)[l);  I!  remember,  0 based! 

-To  make  a one-dimensional  reference  to  one  of  the  sub-arrays:  int  [ 1 copy  = a2d[l); 

-Short-cut  initialization  of  a 2 x 3 array:  int[)()  x = ( { 2,3,4  },  ( 7,8,9  } ); 

- To  make  a 2d  array  with  irregular  dimensions: 

int [ 1 II  y = new  int  f 2 ) [];  //  makes  only  the  first  array,  with  a length  of  2 

y[0]  = new  int  (3];  //  makes  the  first  sub-array  3 elements  in  length 

y ( 1 ] = new  int  (5);  //  makes  the  second  sub-array  5 elements  in  length 
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And  the  number  one  topic  that  didn’t  quite  make  it  in... 

#1  Enumerations  (also  called  Enumerated  Types  or  Enums) 


We’ve  talked  about  constants  that  are  defined  in  the  API,  for  instance, 
JFrame.EXIT_ON_CLOSE.  You  can  also  create  your  own  constants  by 
marking  a variable  static  final.  But  sometimes  you’ll  want  to  create  a set 
of  constant  values  to  represent  the  only  valid  values  for  a variable.  This  set  of 
valid  values  is  commonly  referred  to  as  an  enumeration . Before  Java  5.0  you 
could  only  do  a half-baked  job  of  creating  an  enumeration  in  Java.  As  of  Java 
5.0  you  can  create  full  fledged  enumerations  that  will  be  the  envy  of  all  your 
prejava  5.0-using  friends. 

Who’s  in  the  band? 


Let’s  say  that  you’re  creating  a website  for  your  favorite  band,  and  you  want  to 
make  sure  that  all  of  the  comments  are  directed  to  a particular  band  member. 

The  old  way  to  fake  an  “enum”: 


public 

static 

final 

int 

JERRY 

public 

static 

final 

int 

BOBBY 

public 

static 

final 

int 

PHIL  : 

IVeVe  hoping  -that  by  the  time  we  got  here 
seledtedBandMember"  has  a valid  value/ 

//  do  JERRY  related  stuff 

} 


//  later  in  the  code 
if  (selectedBandMember  ==  JERRY)  { 


The  good  news  about  this  technique  is  that  it  DOES  make  the  code  easier  to 
read.  The  other  good  news  is  that  you  can’t  ever  change  the  value  of  the  fake 
enums  you’ve  created;  JERRY  will  always  be  1.  The  bad  news  is  that  there’s 
no  easy  or  good  way  to  make  sure  that  the  value  of  selectedBandMember 
will  always  be  1,  2,  or  3.  If  some  hard  to  find  piece  of  code  sets 
selectedBandMember  equal  to  812,  it’s  pretty  likely  your  code  will  break... 
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#1  Enumerations,  cont. 

The  same  situation  using  a genuine  Java  5.0  enum.  While  this  is  a very  basic 
enumeration,  most  enumerations  usually  are  this  simple. 


A new,  official  “enum”:  _ 

public  enum  Members  { JERRY , BOBBY , PHIL  }; 
public  Members  selectedBandMember ; 

//  later  in  the  code 

if  (selectedBandMember  ==  Members . JERRY)  { 
//  do  JERRY^r elated  stuff 

Ho  need  to  worry  about  this  variable's  value./ 


W da*  ****** 

The  variable  is  of  -typ€ 

"Members*,  ay *d  dan  OKL/  have  a value  of 

’•JERRy" > "BOBBY",  or  TttlL". 


Tbc  syntax  to  ref*-  to  an  enum  uinstandew 


Your  enum  extends  java.Iang.Enum 

When  you  create  an  enum,  you’re  creating  a new  class,  and  you’re  implicitly  extending 
java . lang.  Enum.  You  can  declare  an  enum  as  its  own  standalone  class,  in  its  own 
source  file,  or  as  a member  of  another  class. 

Using  “if”  and  “switch”  with  Enums 

Using  the  enum  we  just  created,  we  can  perform  branches  in  our  code  using  either 
the  if  or  switch  statement.  Also  notice  that  we  can  compare  enum  instances  using 
either  ==  or  the  . equals  ( ) method.  Usually  ==  is  considered  better  style. 


_______ Assijrmj  dr  ewwr  value  to  a variable- 

Members  n = Members . BOBBY;  4: — " 

if  (n . equals (Members . JERRY) ) System. out .print In (" Jerrrry ! " ) ; 
if  (n  mm  Members . BOBBY)  System. out . println ( "Rat  Dog");  f. 

-(ap* 

Members  ifName  = Members . PHIL; 
switch  (ifName)  { 

case  JERRY:  System. out . print ("make  it  sing  ") ; 

case  PHIL:  System. out  .print  ("go  deep  ")  ; Pop  I^Vhai's -the  output? 

case  BOBBY : System. out .print In ("Cassidy ! ")  ; 


worV.  frw*! 


jApisseQ  daap  06 
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#1  Enumerations,  completed 


A really  tricked-out  version  of  a similar  enum 


You  can  add  a bunch  of  things  to  your  enum  like  a constructor,  methods, 
variables,  and  something  called  a constantHspecific  class  body.  They're 
not  common,  but  you  might  run  into  them: 


public  class  HfjEnum  ( 


enum  Names  { 

JERRY ( "lead  guitar^)  { public  String  sings ()  { 
return  "plaintively" ; } 

BOBBY ("rhythm  guitar")  ( public  String  sings() 

return  "hoarsely";  } 


), 


PHIL ("bass") ; 


tv*  « tv  '«>  . 

\ait  (*  £>IS  T, 

***  — 

vaW  *f  JERKY  * &°^Y- 


private  String  instrument; 


} 


Names (String  instrument)  { ^ — r 

this . instrument  = instrument; 

) 

public  String  get Instrument ()  { 

return  this . instrument ; 

} 

public  String  sings ()  { 

return  "occasionally"; 

} 


This  is  the  enuw/s  <U5hstruetor.  It  runs 
omu  &t\\  dtd^rtd  «*um  value  (m 
this  ease  it  runs  three  times)- 


Ml  $ee  ik€s<  bemg  tailed  fv-o„  u^i„0". 


public  static  void  main (String  [)  args)  { 
for  (Names  n : Names . values () ) { 

System. out .print (n) ; 

System, out .print (",  instrument : "+  n , get Instrument ( ) ) ; 
System. out .println (",  sings : " + n . sings ( ) ) ; 


iwcs.  vjitVi  a 


> v 


> 


I Fite  Edit  Window  Help  Booties  ] 


%java  HfjEnum 

JERRY,  instrument:  lead  guitar,  sings:  plaintively 
BOBBY,  instrument:  rhythm  guitar,  sings:  hoarsely 
PHIL,  instrument:  bass,  sings:  occasionally 

% 


Notice  that  the  basie  usi 
method  is  ohly  tailed  'wheyi  the 
eriUnv  value  has  no  donstd^t- 
speetfie  elass  body. 
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flVC -jV^n Uf 6 A Long  Trip  Home 

Hysfery 


Captain  Byte  of  the  Flatland  starship  “Traverser”  had  received  an  urgent.  Top  Secret  transmission 
from  headquarters.  The  message  contained  30  heavily  encrypted  navigational  codes  that  the 
Traverser  would  need  to  successfully  plot  a course  home  through  enemy  sectors.  The  enemy 
Hackarians,  from  a neighboring  galaxy,  had  devised  a devilish  code-scrambling  ray  that  was  capable 
of  creating  bogus  objects  on  the  heap  of  the  Traverser’s  only  navigational  computer  In 
addition,  the  alien  ray  could  alter  valid  reference  variables  so  that  they  referred  to  these 
bogus  objects.  The  only  defense  the  Traverser  crew  had  against  this  evil  Hackarian  ray  was 
to  run  an  inline  virus  checker  which  could  be  imbedded  into  the  Traverser’s  state  of  the  art 
Java  1 A code. 

Captain  Byte  gave  Ensign  Smith  the  following  programming  instructions  to  process  the  critical 
navigational  codes: 


‘Tut  the  first  five  codes  in  an  array  of  type  ParsecKey.  Put  the  last  25  codes  in  a five  by  five,  two 
dimensional  array  of  type  QuadmntKey.  Pass  these  two  arrays  into  the  plotCourseQ  method  of  the 
public  final  class  ShipNavigation.  Once  the  course  object  is  returned  run  the  inline  virus  checker 
against  all  the  programs  reference  variables  and  then  run  the  NavSim  program  and  bring  me  the 
results  ” 


A few  minutes  later  Ensign  Smith  returned  with  the  NavSim  output.  “NavSim  output  ready  for 
review,  sir",  declared  Ensign  Smith.  ‘Tine”,  replied  the  Captain,  “Please  review  your  work”.  “Yes 
sir!”,  responded  the  Ensign,  “First  I declared  and  constructed  an  array  of  type  ParsecKey  with  the 
following  code;  ParsecKey  []  p = new  ParsecKey [5];  . next  I declared  and  constructed  an  array 
of  type  QuadrantKey  with  the  following  code:  QuadrantKey  [|  []  q = new  QuadrantKey  [5]  [5]; . 
Next,  I loaded  the  first  5 codes  into  the  ParsecKey  array  using  a ‘for’  loop,  and  then  I loaded  the  last 
25  codes  into  the  QuadrantKey  array  using  nested  ‘for’  loops.  Next,  I ran  the  virus  checker  against 
all  32  reference  variables,  1 for  the  ParsecKey  array,  and  5 for  its  elements,  1 for  the  QuadrantKey 
array,  and  25  for  its  elements.  Once  the  virus  check  returned  with  no  viruses  detected,  I ran  the 
NavSim  program  and  re-ran  the  virus  checker,  just  to  be  safe. . . Sir  ! “ 

Captain  Byte  gave  the  Ensign  a cool,  tong  stare  and  said  calmly,  “Ensign,  you  are  confined  to 
quarters  for  endangering  the  safety  of  this  ship,  I don’t  want  to  see  your  face  on  this  bridge  again 
until  you  have  properly  learned  your  Java!  Lieutenant  Boolean,  take  over  for  the  Ensign  and  do  this 
job  correctly!” 


Why  did  the  captain  confine  the  Ensign  to  his  quarters? 
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flve-MInute  Mystery  Sakisn 


A Long  TVip  Home 

Captain  Byte  knew  that  in  Java,  multidimensional  arrays  are  actu- 
ally arrays  of  arrays.  The  five  by  five  QuadrantKey  array  ‘q\  would 
actually  need  a total  of  31  reference  variables  to  be  able  to  access 
all  of  its  components: 

1 ■■  reference  variable  for  'q* 

5 - reference  variables  for  q[0]  - q [4] 

25  - reference  variables  for  q [0]  [0]  - q[4]  [4] 

The  ensign  had  forgotten  the  reference  variables  for  the  five  one 
dimensional  arrays  embedded  in  the  ‘q‘  array.  Any  of  those  five 
reference  variables  could  have  been  corrupted  by  the  Hackarian 
ray,  and  the  ensign's  test  would  never  reveal  the  problem. 
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Don't  you  know  about  the  web  site? 
We’ve  got  answers  to  some  of  the 
Sharpens,  examples,  the  Code  Kitchens, 
Ready-bake  Code,  and  daily  updates 
from  the  Head  First  author  blogs! 


This  isn’t  goodbye 


Bring  your  brain  over  to 
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